Aurora is a reference-design mobile wallet app for the forthcoming Tari digital currency. The goal is for creators and developers to be able to use the open-source Aurora libraries and codebase as a starting point for developing their own Tari wallets and applications. Aurora also sets the bar for applications that use the Tari protocol. In its production-ready state, it will be a beautiful, easy to use Tari wallet focused on Tari as a default-private digital currency.
Want to contribute to Aurora? Get started here in this repository for Android or here for iOS.
- Install Android Studio 4.0.
- Clone the repository:
git clone https://github.com/tari-project/wallet-android.git
- Open Android Studio, select
Open an existing Android Studio Project
and select the project root folder. - Wait until Android Studio finishes initial downloading, syncing and indexing.
- If you have not yet configured NDK, you should see the "NDK not configured" message at the end of the build and sync process.
- Click "Install NDK ..." link in the build log and accept the license, this will commence NDK and CMake installations. Let Android Studio do more downloading and sync.ing and wait until you see "CONFIGURE SUCCESSFUL" in the build logs.
- At this step, please go to the
SDK Manager
and make sure that both NDK and CMake are installed. - Go to
Build Variants
and selectregularDebug
for the full configuration, orprivacyDebug
for privacy configuration. - Make project. (
Build
→Make Project
) OPTIONAL
secret.properties
file in the project folder contains application secrets and will be generated for you with default values during the build process. Please follow the comments in this file and edit if required.OPTIONAL
The regular build of Aurora uses Sentry for error monitoring.sentry.properties
file in the project folder contains Sentry configuration and will be created with empty values for you during the build process. Please follow the comments in this file and edit with your Sentry server values if you'd like to enable crash reporting.- Voila 🎉 You're now ready to run Aurora! Please follow the next item on how to setup your emulator, or you can already run it on your device.
Aurora Android native libraries only support armeabi-v7a
, arm64-v8a
and x86_64
ABIs. Therefore you can only run Aurora on devices and emulators with a supported ABI. Android Studio emulators use the unsupported x86
ABI as default, but you can download an x86_64
image for your emulator and run Aurora on it. Please Download
an x86_64
image under the x86 Images
tab in the System Image
step of Virtual Device Configuration.
Tari native wallet library version to be used by Aurora is specified by the ext.libwalletVersion
in the build.gradle
file in the project root directory. Aurora build script automatically fetches the native libraries of this version into the libwallet
folder in the root directory during the build process. Any library files you place in this folder will be deleted and replaced by this automatic download process.
If you want to disable the automatic download and use the native libraries of your choice, please comment out the line preBuild.dependsOn("downloadLibwallet")
in the file app/build.gradle
.