QRL Mobile wallet
This mobile application is based on the react-native framework to provide an Android and iOS implementation of the QRL wallet.
General information
The mobile-wallet apps are still under heavy development. Please be aware that frequent changes will occur to this repository.
Requirements
Common to iOS and Android
- React-Native (https://facebook.github.io/react-native/)
- CMake (https://cmake.org/)
iOS specific
- XCode
- Cocoapods (https://cocoapods.org/)
Android specific
- Android Studio (https://developer.android.com/studio/install)
- Gradle (https://gradle.org/): can be handled within Android Studio
How to generate the iOS libraries
To generate the iOS libraries you need to clone the theQRL/qrllib and build the *.a iOS libraries (for the simulator and real device) using Xcode.
git clone https://github.com/theQRL/qrllib
git submodule update --init --recursive
cd qrllib
mkdir build
cd build
cmake -G Xcode ..
These commands will generate a new Xcode project called qrllib.xcodeproj.
Open the Xcode project and build the 4 different libraries (dilithium, kyber, qrllib and shasha) for the iOS simulator and "iOS generic device". You will see all the generated libraries under build/Debug-iphoneos and build/Debug-iphonesimulator directories.
How to generate the Android libraries
To generate the Android libraries you need to load the /android project folder in Android Studio and open the build-gradle file.
Open the "Gradle menu" and double click on "android:app [externalNativeBuildDebug]" under the "Run Configurations" category to start building the libraries.
The generated *.so libraries are located under android/app/build/intermediates/cmake/debug/obj/.
How to update proto files
In case of any change on the proto file, one needs to regenerate the gRPC pods
rm -rf Pods
rm Podfile.lock
pod install
Load the generated libraries to the mobile-wallet app
- Open the mobile-wallet Xcode project (ios/theQRL.xcworkspace)
- Click on the project name (theQRL) and select theQRL under the TARGETS list
- Add all the generated .a libraries to the Linked Frameworks and Libraries section
RN <-> native code communication
For more information about the communication between React-Native and native code (Objective-C and c++) check the original Communication between native and React Native documentation.
