4.4 KiB

Raw Blame History

Note: To be able to fully test the QR Scan screen and its logic, we recommend you to test it on real Android devices, which have hardware camera accessories. Although there is a way on how to test the scanning functionalities on an Android emulator too. See the next section on how to set up a QR code for the emulated camera scene.

Test Prerequisites

Prepare at least two Zcash wallet addresses - one valid and one invalid. A valid address for Testnet can be tmEjY6KfCryQhJ1hKSGiA7p8EeVggpvN78r. The invalid one can be its modification.
Check you have a wallet configured in the Zcash wallet app
Open Zcash wallet app in the system Settings app. Visit the permissions screen, then select Camera and make sure that you have the Camera permission denied.
The previous step of resetting the Camera permission needs to be repeated before each following subtests by one of these ways:
- Reset the wallet app data from system Settings app to reset the Camera permission
- Reinstall the wallet app
- Change the Camera permission settings by switching between available options (the options may differ on different Android SDK versions).

Android emulator setup (optional)

This section is optional and is required only if you'd like to test on an Android emulator device.

Follow these steps to download and install Android studio
And these steps help you set up an Android emulator
Then you'll need to create a valid Zcash address QR code image. It can be done, for example, with the QR Code Generator tool.
Download the image
Start the emulator
Click on More in the emulator panel to open the Extended controls window
Click on Camera
Click Add Image in the Wall section
Select your QR code image and close the window
Once you're in the QR Scan screen with the virtual camera opened, see these instructions on how to move in virtual scene.
The last step is to let the scanner read your QR code to be able to move to the smaller room (behind the dog), which will have the code displayed on the room wall.

Check Camera permission allow functionality

Open QR Scan screen by QR code icon from the Home screen
Camera permission dialog should be prompt
Grant camera permission with Allow button (or its modifications)
Camera view and its square frame should appear

Check Camera permission deny functionality

Open QR Scan screen by QR code icon from the Home screen
Camera permission dialog should be prompt
Deny camera permission with Deny button (or its modifications)
Camera view and its square frame shouldn't be visible. The screen should be black. Also, Open system Settings app button on the bottom side of the screen should be visible now.
Hit the button.
System Settings app should open on the Zcash wallet app screen.

Check Camera permission dismiss functionality

Open QR Scan screen by QR code icon from the Home screen
Camera permission dialog should be prompt
Dismiss the Camera permission by back navigation or by touching outside the Camera permission popup
Rotate the device to trigger a configuration change (make sure the screen rotation is enabled on the device)
Ensure that the Camera permission is shown again
Leave the QR Scan screen by back navigation; you're on Home screen now
Ensure that Camera permission is not shown above the Home screen

Scan valid QR code

Grant the Camera permission with one of the previous procedures
Create QR code from the valid Zcash wallet address. You can use, for example, the QR Code Generator tool.
Scan the created QR code
The code should be scanned and validated
App should then close the QR Scan screen and navigate to another screen to proceed with the scanned result

Scan invalid QR code

Grant the Camera permission with one of the previous procedures
Create QR code from the valid Zcash wallet address. You can use, for example, the QR Code Generator tool.
Scan the created QR code
The code should be scanned but not validated (error message is displayed).
The app UI should not be changed and the Camera view should be still available for scanning another codes

4.4 KiB Raw Blame History