From 76a96639684bd602c2e5e963a15b98a34351aee9 Mon Sep 17 00:00:00 2001
From: dab246 <tdvu@linagora.com>
Date: Tue, 11 Apr 2023 14:22:13 +0700
Subject: [PATCH] TF-1665 Update docs `app_grid_configuration.md`

(cherry picked from commit b670472d77437336861248a1d785345965b311af)
---
 docs/configuration/app_grid_configuration.md | 36 ++++++++++++++++++--
 1 file changed, 33 insertions(+), 3 deletions(-)

diff --git a/docs/configuration/app_grid_configuration.md b/docs/configuration/app_grid_configuration.md
index aa29d7f0a..abd5a58c9 100644
--- a/docs/configuration/app_grid_configuration.md
+++ b/docs/configuration/app_grid_configuration.md
@@ -13,7 +13,10 @@
     {
       "appName": "Contacts",
       "icon": "ic_contacts_app.svg",
-      "appLink": "https://openpaas.linagora.com/contacts/"
+      "appLink": "https://openpaas.linagora.com/contacts/",
+      "androidPackageId": "xxx",
+      "iosUrlScheme": "xxx",
+      "iosAppStoreLink": "xxx"
     }
 ```
 
@@ -25,12 +28,18 @@ For example:
     {
       "appName": "Twake",
       "icon": "ic_twake_app.svg",
-      "appLink": "http://twake.linagora.com/"
+      "appLink": "http://twake.linagora.com/",
+      "androidPackageId": "xxx",
+      "iosUrlScheme": "xxx",
+      "iosAppStoreLink": "xxx"
     },
     {
       "appName": "App 1",
       "icon": "ic_twake_app.svg",
-      "appLink": "http://twake.linagora.com/"  
+      "appLink": "http://twake.linagora.com/",
+      "androidPackageId": "xxx",
+      "iosUrlScheme": "xxx",
+      "iosAppStoreLink": "xxx"
     },
     ...
   ]
@@ -40,9 +49,30 @@ For example:
 - `appName`: The name will be showed in App Grid
 - `icon`: Name of icon was added in `configurations\icons` folder
 - `appLink`: Service URL
+- `androidPackageId`: ApplicationId of android app
+- `iosUrlScheme`: UrlScheme name of the ios app.
+- `iosAppStoreLink`: iTunes link of the ios app. 
+Allow navigate to store (appStore) if app is not found in the device. Example:
+`itms-apps://itunes.apple.com/us/app/linshare/id1534003175` or `https://itunes.apple.com/us/app/linshare/id1534003175`
 
 2. Enable it in [env.file](https://github.com/linagora/tmail-flutter/blob/master/env.file)
 ```
 APP_GRID_AVAILABLE=supported
 ```
 If you want to disable it, please change the value to `unsupported` or remove this from `env.file`
+
+3. Enable open app on mobile(Android/iOS)
+
+- In `Android 11+` to open another app already installed, you have to add the package with name `ApplicationId`' in [AndroidManifest](https://github.com/linagora/tmail-flutter/blob/master/android/app/src/main/AndroidManifest.xml) inside `queries` tag. Example:
+```
+<queries>
+   <package android:name="com.linagora.android.linshare" /> 
+</queries>
+```
+- - In `iOS 9+` to open another app already installed, you have to add the `UrlScheme`' in [Info.plist](https://github.com/GeekyAnts/external_app_launcher/blob/master/example/ios/Runner/Info.plist) under the `LSApplicationQueriesSchemes` key. Example:
+```
+<key>LSApplicationQueriesSchemes</key>
+<array>
+    <string>linshare.mobile</string>
+</array>
+```