Adding Android Quickstart

[vcampitelli]

There are some things that I wanted to check before we can actually merge this:

• Decide on the name: should it actually be "Java for Android"?
• I've named the sample repo as fusionauth-quickstart-android-java but the Quickstart instructions expects fusionauth-quickstart-LANGUAGE-FRAMEWORK-{api,web}, so maybe I should append -native? I didn't because it seems redundant.
• The Issuer should match the instance URL, so the user should expose the instance with ngrok, update the Issuer and recreate asymmetric keys. Should I add these steps to the guide or create a simple script (probably add a command to the Node CLI) that does all that automatically?

---

• To see the specific tasks where the Asana app for GitHub is being used, see below:
  • https://app.asana.com/0/0/1205088227520253
  • https://app.asana.com/0/0/1205273462533594

[mooreds]

Decide on the name: should it actually be "Java for Android"?

How about "Android Java Quickstart"?

I've named the sample repo as fusionauth-quickstart-android-java but the Quickstart instructions expects fusionauth-quickstart-LANGUAGE-FRAMEWORK-{api,web}, so maybe I should append -native? I didn't because it seems redundant.

How about fusionauth-quickstart-java-android-native (or -mobile)? Either seem accurate.

The Issuer should match the instance URL, so the user should expose the instance with ngrok, update the Issuer and recreate asymmetric keys. Should I add these steps to the guide or create a simple script (probably add a command to the Node CLI) that does all that automatically?

Hmmm. Can you have this be a config setting, where you stand up FusionAuth with ngrok, update a settings file someplace, then build the android app?

[vcampitelli]

How about "Android Java Quickstart"?

Done

How about fusionauth-quickstart-java-android-native (or -mobile)? Either seem accurate.

Done

Hmmm. Can you have this be a config setting, where you stand up FusionAuth with ngrok, update a settings file someplace, then build the android app?

What do you mean by "config setting"?

[mooreds]

What do you mean by "config setting"?

When I am building an android app, is there a corresponding config file, similar to .env for docker or php, where a user could set up the ngrok URL?

So I'm talking about build time configuration, not runtime configuration.

Does that make sense?

[mooreds]

@Aaron-Ritter @ColinFrick please determine who is the best person to review, tagged you both.

[vcampitelli]

When I am building an android app, is there a corresponding config file, similar to .env for docker or php, where a user could set up the ngrok URL?

Yes, it does. That's why I asked if it would be better to write these steps to the quickstart (expose the instance with ngrok, update the Issuer, recreate asymmetric keys, update settings file) or create a simple script to do all that.

[mooreds]

That's why I asked if it would be better to write these steps to the quickstart (expose the instance with ngrok, update the Issuer, recreate asymmetric keys, update settings file) or create a simple script to do all that.

Ah, okay. Since this won't be done typically (people will probably work through the quickstart once, not multiple times) I think documentation is fine.

[vcampitelli]

1. I've pushed an additional step on configuring issuer and regenerating JWT keys.
2. I've also created a <IconButton> component to render UI-like buttons, like we had with markdown/asciidocs, and updated DocsDevREADME with instructions.
   
3. As discussed with @mooreds, I didn't recreate the exact same Changebank theme as things aren't that easy with Android, but I used the same color, texts and functionality.

[ColinFrick]

After completing the tutorial the app didn't start. I had to remove following files first:

• app/java/io/fusionauth/app/BrowserSelectionAdapter.java
• app/res/layout/browser_selector_layout.xml

[mooreds]

@vcampitelli is this ready for @ColinFrick to re-review?

[vcampitelli]

Yup, just pushed the kickstart file that was missing.

Can you please review it again @ColinFrick ?

[ColinFrick]

@vcampitelli Quick start looks good. I have found a typo in the kickstart.json.

See FusionAuth/fusionauth-quickstart-java-android-native@8a38be2#r127101206

[vcampitelli]

Done! Thanks @ColinFrick

@mooreds this is now ready for you to review