search

tari-project / wallet-android

The Tari Wallet application for Android
BSD 3-Clause "New" or "Revised" License
40 stars 25 forks source link

readme

Actions Status

Actions Status

What is Aurora?

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.

   

Build Instructions

  1. Install Android Studio 4.0.
  2. Clone the repository: git clone https://github.com/tari-project/wallet-android.git
  3. Open Android Studio, select Open an existing Android Studio Project and select the project root folder.
  4. Wait until Android Studio finishes initial downloading, syncing and indexing.
  5. If you have not yet configured NDK, you should see the "NDK not configured" message at the end of the build and sync process.

  6. 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.

  7. At this step, please go to the SDK Manager and make sure that both NDK and CMake are installed.

  8. Go to Build Variants and select regularDebug for the full configuration, or privacyDebug for privacy configuration.

  9. Make project. (Build → Make Project)
  10. 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.
  11. 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.
  12. 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.

Emulator Configuration

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.

Using Your Custom Native Library (FFI) Version

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.

For updating openssl

https://github.com/217heidai/openssl_for_android/releases