virtualrobot-androidstudio-mac.md

Setup Virtual Robot in Android Studio on macOS

Installing dependencies

1. Download git, java, and 360Controller.

   360Controller WILL NOT install on macOS Big Sur or newer.

2. Run the installers for each.

   If macOS complains that the installer is not signed by an identified developer, you may need to override it. See Apple's support page for details.

   

Installing Android Studio

1. Download the Android Studio installer.

2. Open the installer, and drag the "Android Studio" icon into the "Applications" folder. ONLY DO THIS ONCE! Close the installer.

   

3. Open the newly installed Android Studio app.

   See Open Apps and Documents on Mac

4. In the setup helper, select the "Standard" installation type. Leave all of the default settings.

Loading the Virtual Robot project

1. In Android Studio, select "Get from VCS".
2. Select the GitHub tab.
3. Add a GitHub token
   1. Select "Use token..."
   2. Select "Generate..."
   3. It will open the GitHub token creation page.
   4. Leave everything the same except the Expiration, set this to "No expiration". You may need to change the Note section if you have another token with the same name.
   5. Scroll to the bottom and select "Generate token".
   6. Copy the resulting token (ghp_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX).
   7. In Android Studio, paste this token and click "Log In".
4. In the list of repositories, select your fork of virtual robot (virtual-robot or similar).

   It is recomended that you clone your own personal fork, not the panthera2021/virtual-robot repo because you need to do the tutorial by yourselves.

5. Click "Clone".