DEV_SETUP.md

Beta Testing/Development Setup

• If you are a Beta-tester that does not have a smartphone device with Android 9 (Pie) or up installed, then you can follow these steps to run the WalletWatch app in an emulator on your computer.
• If you would like to contribute to this open-source project, then these steps will get you setup in the development environment.

Step-By-Step Walkthrough

1. Download the appropriate installer file for your computer from this link:

• https://developer.android.com/studio

2. Locate the downloaded installer file in your Downloads folder on your computer.

3. Double-click the installer file to run the installation of Android Studio. Windows users should preferably right-click the file and then click Run as administrator, if able. You may also refer to this link for additional installation instructions, especially if your computer is a Linux machine:

• https://developer.android.com/studio/install

4. Click Next >.

5. Make sure both the Android Studio checkbox and Android Virtual Device checkbox are checked. Then, click Next >.

6. If you would prefer a different installation location, then select or enter the desired location. Then, click Next >.

7. If you would prefer not to have an Android Studio shortcut on your desktop, select Do not create shortcuts. Then, click Install.

8. Wait for the installation of Android Studio to complete. This will take several minutes. Then, click Next > when it has completed.

9. Make sure the Start Android Studio checkbox is checked. Then, click Finish.

10. A popup will appear. Check the Do not import settings checkbox. Then, click OK.

11. On the next popup, select whether or not you want to allow Google the ability to collect anonymous usage data.

12. The Setup Wizard for Android Studio will appear. Click Next.

13. Check the Standard checkbox. Then, click Next.

14. Check the checkbox of your preferred theme. Then, click Next.

15. Click Next.

16. Click Finish.

17. Wait for the installation of the Android SDK to finish. This will take several minutes. Then, click Finish.

18. Download a ZIP file of the WalletWatch GitHub repo by clicking this link:

• https://github.com/thedavidang/CSC4151/archive/master.zip

19. Locate the downloaded ZIP file in your Downloads folder on your computer. Right click the ZIP file. Then, click Extract All....

20. Click Extract to extract the repo files out of the ZIP file.

21. Android Studio should have popped up a small welcoming window. Click Open an existing Android Studio project. In the navigation popup, locate the Development folder within the extracted repo folder. The Development folder should have a green Android robot icon next to it.

22. Android Studio should now launch and load the WalletWatch project. Wait for Android Studio to finish automatically installing the libraries and other modules needed to run WalletWatch. This will take several minutes. You may recieve an Android SDK warning popup, which you may ignore. You may recieve a firewall warning popup, in which case you should allow Android Studio the ability to use the Java SDK.

23. Once Android Studio has finished running the background processes of installing the modules, click the No Devices drop-down menu in the top menubar. Then, click Open AVD Manager.

24. The AVD Manager wizard will popup, which lets you create an emulator of an Android smartphone device, which acts as a virtual machine within Android Studio. Click + Create Virtual Device....

25. Select a Phone that supports Android 9 (Pie) or up, such as the Pixel 3. Then, click Next.

26. Click Download next to the desired Android 9+ version, such as Android 10 Q, to download the Android SDK on to the virtual device.

27. A popup will appear asking you to agree to the terms of two different license agreements. Click Accept to both. Then, click Next.

28. If you would like to set a different virtual memory size, then drag the slider as desired. Otherwise, use the recommended size. Then, click Next.

29. Wait for the installation of the virtual device and Android SDK to finish. This will take several minutes. Then, click Finish.

30. Click Finish.

31. Click Next.

32. Make sure the starting orientation is set to Portait. Then, click Finish.

33. The AVD Manager will close. Now to start the emulator and run the WalletWatch app within it, click the green arrow play button in the top menubar. Alternatively, you may use the "Shift+F10" key command.

34. Wait for the emulator to startup. This will take a couple minutes. The emulator will automatically bypass the lock screen and then install the WalletWatch app on to the emulator. This will take a couple more minutes. Finally, the emulator will launch the WalletWatch app.

35. When you are done testing the app, you may close the emulator by long-clicking the power button in the emulator sidebar and then clicking Power Off within the emulator. Alternatively, you may simply click the tiny x button in the emulator sidebar. You may then close Android Studio.