To save time during the workshop itself, we decided to create these prerequisites that include some environment preparations, which are kind of "standard" and necessary for saving time and focusing during this workshop on what important. So please follow the instructions carefully and if you have any questions feel free to ask them via Telegram Channel or Facebook Group.

1. Create a new "Hello World" application in Android Studio.
2. Build and compile a project.
3. Create a Github repository for this project. You can follow the instructions here.
Please note - during the project creation, do not mark to create any files on your behalf, just leave all checkboxes empty like this one:
image_caption
4. Open terminal in Android Studio and run: 

mkdir -p .github\workflows && cd .github\workflows && copy NUL test.yaml


5. Create first commit (we just want to verify our local copy is synced with remote). From the app root folder, open terminal and run:

Note: pay attention to change a path to Github repository in the next script

git init
git add .
git commit -m "Initial commit"
git remote add origin <path to your repository i.e. git@github.com:rtokun/test-111.git>
git push origin main

If you wasn't able to commit and push please see troubleshooting here or ask for help in our Telegram Channel or Facebook Group.

We want to create a Firebase project and connect it to our application.

1. Create a Firebase project for our app

  1. Go to Firebase console, login, and click Add project.
  2. Follow the wizard instructions and complete project creation, including entering package details from our app (exact package name can be found in Manifest.xml file).
  3. In the project overview click Add app: image_caption
  4. Select Android and follow the wizard. Complete the wizard including downloading the google-services.json file and putting it inside the app folder, and modifying the Gradle files.
  5. Make sure to compile and run the application on the emulator/device after successful integration.
  6. Commit and push all changes you have done to the Github repo.

2. Create Firebase Login token

This token allows to 3rd party applications to get access to the Firebase project and make operations. We will use this token in the workshop. To get one we need to install the Firebase console client on our local computer and login via client to our Firebase account.

(Mac Users) Firebase CLI installation:

Open terminal and enter

curl -sL https://firebase.tools | bash

(Windows Users) Firebase CLI installation:

  1. Download and install the Firebase CLI binary for Windows from here.
  2. Access the binary, open a shell and verify you can run the firebase command.

After successful installation enter in terminal:

firebase login:ci

It will open the browser with the Authentication page. Enter your credentials and after successful authentication go back to your terminal window, you should see there your token:

✔  Success! Use this token to log in on a CI server:

1//03UkAUZpVhigPCgYIARAAGsotbjnrtl;ghkjnrts;lhkjntw;lhknrt;lhbknwrtl;khn;wlr0VcRQiYGtZSpo7DP1aS7X5OdCVJys

Copy this token to safe place, we will use it during workshop.

At the end of these prerequisites we have to get 4 things:

  1. Android "Hello World" starter project.
  2. Created the Github repository and connected it to our local app.
  3. Firebase project was created and integrated into our app as well.
  4. Firebase access token.

See you at the workshop! ❤️

403 Failure during push to the remote

  1. Please verify that your github credentials are correct.
  2. Try to connect via SSH rather than HTTPS. If you still want to use HTTPS, please use Github private access token instead of password for your account:
    1. Follow instructions here to create access token (Please make sure to mark all permissions checkboxes during token creation).
    2. Go to Android Studio -> Settings/Preferences -> Version Control -> GitHub.
    3. Click the + button.
    4. In the dialog that opens, select Use token and paste your token.
    5. Save and try to push to the repository again.