app_links_module 1.0.1

App Links Module for Dynamic Links and Universal Links.

app_links_module

Dynamically handle incoming links in your app.

App Configuration

1. If the juneflow project doesn't exist, please create it by following this guide.
2. open terminal in the juneflow project root directory, enter the following command.

june add app_links_module

WebSite Configuration

1. use this template, create new repository in your github account.
2. clone the repository to your local computer.
3. go to cloudflare, login and select Workers & Pages > Overview > Create application > Pages Tap > Connect to Git > select the repository you just created. > Begin setup > Save and Deploy.
4. open cloned project, go to index.html file, replace the content with the following code.

• [your_scheme] -> your app scheme name. ex) myapp
• [your.app.package] -> your app package name. ex) com.example.myapp

android part setting

5. get sha-256 fingerprint from your app

• if you want get debug fingerprint on mac, enter the following command in terminal.
  • if your computer not installed java, please install it first.
    • go to install page, download and install [macOS x64 Installer.]

keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android

• if you want get debug fingerprint on windows, enter the following command in terminal.
  • if your computer not installed java, please install it first.
    • go to install page, download and install [Windows x64 Installer.]
    • go to settings > system > about > advanced system settings > environment variables > system variables > path > edit > new > paste the path.
      • ex) C:\Program Files\Java\jdk-16\bin
    • create new android project and run once to generate the debug.keystore file.

keytool -list -v -keystore "C:\Users\[UserName]\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android

• if you want get release fingerprint, create appbundle and upload to google play store, then you can find the sha-256 fingerprint in app signing section in google play console.

flutter build appbundle

6. replace [11:22:33:44:55:66...] in [.well-known/assetlinks.json] file with the sha-256 fingerprint you just got.
7. replace [your.package.name] in [.well-known/assetlinks.json] file with your app package name. ex) com.example.myapp

ios part setting

8. replace [apple team id] in [.well-known/apple-app-site-association] file with your apple team id.

   • you can find your apple team id membership section in apple developer account.

9. replace [[app bundle id]] in [.well-known/apple-app-site-association] file with your app package name. ex) com.example.myapp

10. commit and push to github for update cloudflare pages.

Android Configuration

1. add the app link and deep link code inside .MainActivity activity in android/app/src/main/AndroidManifest.xml file.

• replace [your_scheme] with your app scheme name. ex) myapp
• replace [your.app.package] with your app package name. ex) com.example.myapp
• replace [your.web.site] with your web site url that you created in step 5.

<!-- App Link -->
<intent-filter android:autoVerify="true">
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="http" android:host="[your.web.site]" />
    <data android:scheme="https" android:host="[your.web.site]" />
</intent-filter>

<!-- Deep Link -->
<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <!-- Add optional android:host to distinguish your app
         from others in case of conflicting scheme name -->
    <data android:scheme="[your_scheme]" android:host="[your.app.package]" />
    <!-- <data android:scheme="sample" /> -->
</intent-filter>

iOS Configuration

1. open xcode in /ios/Runner.xcworkspace, go to Runner > Info > URL Types > add new URL Type. > add URL Schemes with your app scheme name. ex) sample
2. go to Signing & Capabilities > + Capability > Associated Domains > add new Associated Domain. > add your web site url with applinks prefix. ex) applinks:your.web.site
   • Warning
     • when write applinks prefix, do not add https:// prefix. ex) applinks:your.web.site
     • do not add / at the end of the url. ex) applinks:your.web.site

MacOS Configuration

1. open xcode in /macos/Runner.xcworkspace, go to Runner > Info > URL Types > add new URL Type. > add URL Schemes with your app scheme name. ex) sample
2. go to Signing & Capabilities > + Capability > Associated Domains > add new Associated Domain. > add your web site url with applinks prefix. ex) applinks:your.web.site
   • Warning: when write applinks prefix, do not add https:// prefix. ex) applinks:your.web.sit
   • do not add / at the end of the url. ex) applinks:your.web.site

Usage

final _appLinks = AppLinks(); // AppLinks is singleton

// Subscribe to all events (initial link and further)
_appLinks.uriLinkStream.listen((uri) {
    // Do something (navigation, ...)
});