zec
/
secant-android-wallet
mirror of https://github.com/zcash/secant-android-wallet.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
secant-android-wallet/docs/testing/manual_testing/App Packaging.md

2.3 KiB
Raw Blame History

  • Debug APK contents — Androidx libraries include extra text files that Android Studio reads during debugging. We need to make sure these files are preserved for debug builds.

    1. Create a debug build of the app, e.g. ./gradlew :app:assembleDebug
    2. View the APK in Android Studio
      1. Build menu
      2. Analyze APK
      3. Open the APK that was built in the first step above
    3. Verify the APK contains various debug properties and versions files in the root directory and under META-INF/

  • Release APK contents

    1. Create a debug build of the app, e.g. ./gradlew :app:assembleRelease
    2. View the APK in Android Studio
      1. Build menu
      2. Analyze APK
      3. Open the APK that was built in the first step above
    3. Verify the APK contains various debug properties
      • Verify the unzipped directory contains the following:
        • AndroidManifest.xml
        • assets/
        • classes.dex (and perhaps additional classesN.dex)
        • compact_formats.proto
        • darkside.proto
        • google/
        • lib/
        • META-INF/ (which should only contain a few files)
        • res/
        • resources.arsc
        • service.proto

  • Sanity check release app

    1. Open gradle.properties file and ensure that you have the IS_SIGN_RELEASE_BUILD_WITH_DEBUG_KEY property set to true. Don't forget to switch the property back to false after this test, so any of your subsequent tests are not affected by it.
    2. Create a release build of the app, e.g. ./gradlew :app:bundleRelease :app:packageZcashmainnetReleaseUniversalApk. Note these Gradle tasks will create an app bundle, then derive the APK from the app bundle. This more closely matches how the app would be distributed to users through Google Play.
    3. Connect an Android device with developer mode enabled to your computer
    4. On a computer with the Android developer tools, run adb logcat
    5. Install the app on the device, e.g. adb install -r $pathToUniversalApk
    6. Run the app
    7. Verify
      1. The app launches successfully
      2. Minimal logs from the app are printed to logcat. Android itself may print logs, but our release build should have logging stripped out
      3. The app is using mainnet