adc774a20d
* [#312] [#309] Scaffold Scan QR Screen - Screen scaffolding. - Model classes. - Screen states handling. - Needed dependencies added. - Camera permission handling. Redirect to Settings. - Added SettingsUtilTest class. - Added view classes tests. - Renamed tag class in update package. - Fix the scan frame size while changing the screen orientation. - Use local variable for cameraProvider. - Use UUID for source of randomness. - Eliminate blocking call for camera. - Fix preview name. - Remove Google Guava dependency. - Suppress Lint warning. - Improved calculation of the camera frame size. Moved it into Constraint layout. - Added custom image analyser class. - Implemented logic for the QR scan screen while QR code is found. - Manual tests added. - New module with integration tests for QR Scan screen. Added 3 integration and 4 view tests. - Simplify QR Scan screen view basic tests. - Switched from pure compose permission handling to Accompanist way of handling CAMERA permission. - Added validation of Zcash wallet address from QR scanning result. - Fix the integration tests for the CI WTF emulator runs. - Add comment on RTL test result. - Improve waitForDeviceIdle() method. Use it on the other test too. - Change the integration test module main manifest package name. - Debounce scans. - Improve thread safety of scan collection. - Added instructions on how to set up an emulator in manual tests. - Replace compose collectAsState() with coroutine launch(). - Add sample() to get rid of several callback events at the same time. - Stop updating the scanState when it's already in Scanning state. - Fix condition on navigation. - Remove validateJob check. - Speed up the integration test - Wrap ImageAnalysis.qrCodeFlow to remember. - Auto-close the camera image when we're done with it in all cases. - Update minimal SDK version to 24 for WTF emulators. - Update Architecture documentation. - Removed extra blank space in ui-design module definition. - Add ui-integration-test-lib. - Update Mermaid diagram with newly added module. - Move UI modules into one wrap in the diagram. - Move sdk-ext-lib and sdk-ext-ui under the same modules section. - Update camera dependencies. Co-authored-by: Carter Jernigan <git@carterjernigan.com> |
||
|---|---|---|
| .github | ||
| .idea | ||
| app | ||
| build-convention | ||
| build-info-lib | ||
| buildSrc | ||
| crash-android-lib | ||
| crash-lib | ||
| docs | ||
| gradle/wrapper | ||
| preference-api-lib | ||
| preference-impl-android-lib | ||
| sdk-ext-lib | ||
| sdk-ext-ui-lib | ||
| spackle-android-lib | ||
| spackle-lib | ||
| test-lib | ||
| tools | ||
| ui-design-lib | ||
| ui-integration-test-lib | ||
| ui-lib | ||
| .gitignore | ||
| LICENSE | ||
| README.md | ||
| build.gradle.kts | ||
| buildscript-gradle.lockfile | ||
| gradle.properties | ||
| gradlew | ||
| gradlew.bat | ||
| settings.gradle.kts | ||
README.md
secant-android-wallet
Note: As of September 2021, this is a brand new project. Since it is being developed in the open from the beginning, initially this project will not be fully functional. Some of the documentation below will be aspirational until the implementation is further along. During this initial stage of development, the older Zcash Android Wallet may be a more helpful sample.
This is a sample implementation of a Zcash wallet for Android leveraging the Zcash Android SDK. The goal is to exercise the SDK and related Zcash libraries, as well as demonstrate how the SDK works.
While we aim to continue improving this sample, it is not an official product. We open sourced it as a resource to make wallet development easier for the Zcash ecosystem.
Getting Started
If you'd like to compile this application from source, please see our Setup Documentation to get started.
Reporting an issue
If you wish to report a security issue, please follow our Responsible Disclosure guidelines. See the Wallet App Threat Model for more information about the security and privacy limitations of the wallet.
If you'd like to report a technical issue or feature request for the Android Wallet, please file a GitHub issue.
General Zcash questions and/or support requests and are best directed to either:
Contributing
Contributions are very much welcomed! Please read our Contributing Guidelines to learn about our process.
Forking
If you plan to fork the project to create a new app of your own, please make the following changes. (If you're making a GitHub fork to contribute back to the project, these steps are not necessary.)
- Change the app name under app/src/main/res/values/strings.xml
- Change the support email address under ui-lib/src/res/ui/support/values/strings.xml
- Remove any copyrighted ZCash or Electric Coin Company icons, logos, or assets
- ui-lib/src/main/res/common/ - All of the the ic_launcher assets
- Change the package name
- Under app/build.gradle.kts, change the package name of the application
- Optional
- Configure secrets for Continuous Integration.
Known Issues
- During builds, a warning will be printed that says "Unable to detect AGP versions for included builds. All projects in the build should use the same AGP version." This can be safely ignored. The version under build-conventions is the same as the version used elsewhere in the application.
- When the code coverage Gradle property
IS_COVERAGE_ENABLEDis enabled, the debug app APK cannot be run. The coverage flag should therefore only be set when running automated tests. - Test coverage for Compose code will be low, due to known limitations in the interaction between Compose and Jacoco.
- Adding the
espresso-contribdependency will cause builds to fail, due to conflicting classes. This is a known issue with the Zcash Android SDK. - Android Studio will warn about the Gradle checksum. This is a known issue and can be safely ignored.
- #96 - Release builds print some R8 warnings which can be safely ignored.
- During app first launch, the following exception starting with
AndroidKeysetManager: keyset not found, will generate a new oneis printed twice. This exception is not an error, and the code is not being invoked twice. - When running instrumentation tests for the app module, this warning will be printed
WARNING: Failed to retrieve additional test outputs from device. com.android.ddmlib.SyncException: Remote object doesn't exist!followed by a stacktrace. This can be safely ignored.