You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
***iOS and Android**— This returns `true` or `false` based on success, and catches errors and returns `false` on failure.
31
+
***iOS and Android**– This returns `true` or `false` based on success, and catches errors and returns `false` on failure.
32
32
33
33
### Important Caveat
34
34
35
35
On both Android and iOS, the result of `OpenDeepLink` (true/false) indicates only that the call succeeded—not whether the target app could actually handle the link. Always test with the actual target apps you expect to open.
36
36
37
-
## Part 2: Inbound — Registering Deep Link Schemes and Hosts
37
+
## Part 2: Inbound – Registering Deep Link Schemes and Hosts
38
38
39
39
Configure deep link schemes and hosts in the PWA Wrapper Builder during the app info step. The builder includes a **Deep Link editor** where you define which schemes and hosts your app should respond to.
***iOS and Android**— This returns `true` or `false` based on success, and catches errors and returns `false` on failure.
31
+
***iOS and Android**– This returns `true` or `false` based on success, and catches errors and returns `false` on failure.
32
32
33
33
### Important Caveat
34
34
35
35
On both Android and iOS, the result of `OpenDeepLink` (true/false) indicates only that the call succeeded—not whether the target app could actually handle the link. Always test with the actual target apps you expect to open.
36
36
37
-
## Part 2: Inbound — Registering Deep Link Schemes and Hosts
37
+
## Part 2: Inbound – Registering Deep Link Schemes and Hosts
38
38
39
39
Configure deep link schemes and hosts in the PWA Wrapper Builder during the app info step. The builder includes a **Deep Link editor** where you define which schemes and hosts your app should respond to.
40
40
41
41
### Adding a Deep Link Entry
42
42
43
43
Each deep link entry requires the following:
44
44
45
-
***scheme** (required) — For example `myapp`, `pwa`, or `https`/`http` for universal/app links
46
-
***host** (required) — Domain or authority to match, for example `example.com`
45
+
***scheme** (required) – For example `myapp`, `pwa`, or `https`/`http` for universal/app links
46
+
***host** (required) – Domain or authority to match, for example `example.com`
47
47
***path** fields (optional, pick one at most):
48
-
***path**— Exact path to match (for example `/profile`)
49
-
***pathStartWith**— Path prefix to match (for example `/jump` catches `/jump/profile`)
***platform**–`Android`, `iOS`, `HarmonyOS`, `all`, or unset (unset or `all` applies to every platform)
52
52
53
53
### Common Deep Link Patterns
54
54
@@ -133,8 +133,8 @@ The `appID` format is `TEAM_ID.BUNDLE_ID`. The `paths` array should match the pa
133
133
134
134
The `.well-known` directory must be accessible at the root of your domain via `https`. The two typical approaches are:
135
135
136
-
* Mendix Cloud — Upload the verification files to your Mendix Cloud environment's static file directory. Refer to [Mendix Cloud documentation](/developerportal/deploy/) for details on serving static files, or contact Mendix Support.
137
-
* Custom Domain or External Hosting — If your Mendix app is behind a reverse proxy or hosted on a custom domain, ensure the `.well-known` directory is properly configured to serve these files at the domain root.
136
+
* Mendix Cloud – Upload the verification files to your Mendix Cloud environment's static file directory. Refer to [Mendix Cloud documentation](/developerportal/deploy/) for details on serving static files, or contact Mendix Support.
137
+
* Custom Domain or External Hosting – If your Mendix app is behind a reverse proxy or hosted on a custom domain, ensure the `.well-known` directory is properly configured to serve these files at the domain root.
138
138
139
139
### Testing File Accessibility
140
140
@@ -162,10 +162,10 @@ One implication of deep links is that your Mendix app's routing (pages, deep-lin
162
162
163
163
When employing deep linking, watch out for the following pitfalls:
164
164
165
-
* Missing verification files — Forgetting to create and host `assetlinks.json` (Android) or `apple-app-site-association` (iOS) for `https` scheme links is the most common integration failure.
166
-
* Using https without domain ownership —`https` scheme links require that you own and control the domain; do not use `https` for domains you do not own.
167
-
* Misinterpreting the `OpenDeepLink`return value — The Boolean result only indicates the call succeeded, not whether the target app successfully opened or handled the link.
168
-
* Mismatched path configuration — Ensure your `path` and `pathStartWith` values match the actual Mendix page URLs or `deep-link` microflow entry points your app exposes.
165
+
* Missing Verification Files – Forgetting to create and host `assetlinks.json` (Android) or `apple-app-site-association` (iOS) for `https` scheme links is the most common integration failure.
166
+
* Using `https` Without Domain Ownership –`https` scheme links require that you own and control the domain; do not use `https` for domains you do not own.
167
+
* Misinterpreting the `OpenDeepLink`Return Value – The Boolean result only indicates the call succeeded, not whether the target app successfully opened or handled the link.
168
+
* Mismatched Path Configuration – Ensure your `path` and `pathStartWith` values match the actual Mendix page URLs or `deep-link` microflow entry points your app exposes.
0 commit comments