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.

Sign up for GitHub

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

Jump to bottom

Document how to configure Android App Link verification #1360

Closed
11 of 12 tasks
m5r opened this issue Apr 23, 2024 · 0 comments · Fixed by #1366
Closed
11 of 12 tasks

Document how to configure Android App Link verification #1360

m5r opened this issue Apr 23, 2024 · 0 comments · Fixed by #1366
Assignees
@m5r

Comments

@m5r
Copy link
Member

m5r commented Apr 23, 2024 •
edited
Loading

With medic/cht-core#8917 merged and medic/cht-android#308 soon to be merged, we should document how to configure a project for its CHT instance to serve /.well-known/assetlinks.json and allow android to automatically associate a domain with a project's app.

Things I can think of from the top of my head:

  • ensure the project's .apk is built with the app_host string configured
    • gotcha: how to handle a single apk with multiple hosts like moh_kenya_echis
  • what goes into assetlinks, reference Android docs:
    • the hardcoded fields relation, target.namespace
    • package_name, application ID declared in build.gradle
    • apk signature, different ways to grab it:
      • keytool -printcert -jarfile ./path/to/project.apk
      • keytool -list -v -keystore ./path/to/release-key.keystore
  • verify it works
    • adb shell pm get-app-links <package_name> shows the domain as verified
    • clicking a link to the app should open the app, not the browser
    • opening the app shouldn't ask to manually verify domains
@m5r m5r moved this from Todo to This Week's commitments in Product Team Activities Apr 23, 2024
@m5r m5r self-assigned this Apr 23, 2024
@m5r m5r mentioned this issue Apr 25, 2024
Merged
@m5r m5r linked a pull request Apr 29, 2024 that will close this issue
feat(#1360): Document how to configure Android App Link verification #1366
Merged
@m5r m5r mentioned this issue Apr 30, 2024
Closed
@m5r m5r closed this as completed in #1366 May 9, 2024
m5r added a commit that referenced this issue May 9, 2024
@m5r @jkuester
feat(#1360): Document how to configure Android App Link verification (#…
58dc697 
…1366)

* progress

* okay

* fix grammar

* Update content/en/apps/reference/app-settings/assetlinks.md

Co-authored-by: Joshua Kuestersteffen <[email protected]>

* Update content/en/apps/reference/app-settings/assetlinks.md

Co-authored-by: Joshua Kuestersteffen <[email protected]>

* Update content/en/apps/features/integrations/android.md

Co-authored-by: Joshua Kuestersteffen <[email protected]>

* Update content/en/apps/features/integrations/android.md

Co-authored-by: Joshua Kuestersteffen <[email protected]>

* assetlinks array

* remove version notes

* branding deep link

* branding deep link

* fix url

* fix url

* keytool commands

* keytool link

* android 12 prompt in integrations

* Update content/en/apps/features/integrations/android.md

Co-authored-by: Joshua Kuestersteffen <[email protected]>

* Update content/en/apps/guides/android/branding.md

Co-authored-by: Joshua Kuestersteffen <[email protected]>

* add `relatedContent`

* point to our docs for asset links in optional properties list

---------

Co-authored-by: Joshua Kuestersteffen <[email protected]>
@github-project-automation github-project-automation bot moved this from This Week's commitments to Done in Product Team Activities May 9, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@m5r m5r

Labels
None yet
Projects
Product Team Activities
Status: Done
Milestone
No milestone
Development

Successfully merging a pull request may close this issue.

feat(#1360): Document how to configure Android App Link verification medic/cht-docs
1 participant
@m5r