Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update README.md #39

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open

Conversation

SilviaCastillo23707
Copy link
Collaborator

No description provided.

@ivanebernal
Copy link
Collaborator

Not sure why you created a new PR for this, but let's continue here since this has the latest changes.

Copy link
Collaborator

@ivanebernal ivanebernal left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is some information missing.. when you clone the project, you need to make some configurations before being able to run it.. those are:

  • Downliading google-services.json and adding it to the project.. this might require to ask the administrators to give access to the firebase project.
  • Creating a property in the user's local gradle.properties file
    For more on that, please speak with Hunter.

Also, we might not need a lot of this information.. for example, to download Android studio, you could just leave the link here and let the user follow the link's instructions.

Copy link
Collaborator

@ivanebernal ivanebernal left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@SilviaCastillo23707 how is this going?

The following link shows in more detail the steps to follow:
[https://firebase.google.com/docs/android/setup#next_steps]


Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add a section to talk about Gradle global variables we need. We currently use User Password and BaseUrl.

Copy link
Collaborator

@ivanebernal ivanebernal left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remember that someone following this document should be able to run the app with no problem; this means that we need to provide the necessary information (no more, no less) that a collaborator needs. You can assume that things like what is Kotlin, what is Android, how to install Android Studio, and all that stuff will be found on the internet; your job here is to provide the missing pieces like:

  • Asking for the google-services.json file
  • Adding global variables to gradle.properties and asking mentors for the correct values
  • Who to ask for an account to be added to a repository
  • Etc.

You can always reach me through Slack to ask me questions about this.

Comment on lines +66 to +67
* It is oriented to API level 16 (Jelly Bean) or higher.
* Use Gradle 4.1 or a more recent version.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No need to clarify this, this is already on the code

* Make sure the config file is not appended with additional characters, like (2).
* Move your config file into the module (app-level) directory of your app.

5. To enable Firebase products in your app, add the [google-services plugin](https://developers.google.com/android/guides/google-services-plugin) to your Gradle files.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This step is not necessary here, this is already done in the code

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You can get rid of steps 5 and 6

* If you added Analytics, run your app to send verification to Firebase that you've successfully integrated Firebase. Otherwise, you can skip the verification step.
* Your device logs will display the Firebase verification that initialization is complete. If you ran your app on an emulator that has network access, the Firebase console notifies you that your app connection is complete.

7. Gradle properties
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We need to use machine level gradle.properties so the secrets are not uploaded to git, please change this section to reflect that. Check this out:
https://medium.com/code-better/hiding-api-keys-from-your-android-repository-b23f5598b906

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Also, you have to mention the specific keys that we need to use, those are User Password and BaseUrl. Remember that someone following this document should be able to run the app with no problem, this means that we need to provide the necessary information (no more, no less) that a collaborator needs.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants