@radhya/mach 2.6.5 → 2.6.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -3
- package/dist/index.js +162 -159
- package/docs/deep-links.md +37 -2
- package/expo-plugin/index.js +15 -12
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -314,12 +314,14 @@ mach deeplink setup
|
|
|
314
314
|
mach deeplink verify
|
|
315
315
|
```
|
|
316
316
|
|
|
317
|
-
When run from the project root, Mach reads `framework`, `scheme`, `ios.bundleIdentifier`, `android.package`, and production submit metadata from `mach.config.json`.
|
|
317
|
+
When run from the project root, Mach reads `framework`, `scheme`, `ios.bundleIdentifier`, `android.package`, and production submit metadata from `mach.config.json`. If the linked project has Mach Web Hosting, setup offers its stable Production address first (`project.getmach.dev`), followed by active Production customer domains, then a manual URL. It deliberately excludes Staging and immutable preview addresses. In most projects, simply run:
|
|
318
318
|
|
|
319
319
|
```bash
|
|
320
|
-
mach deeplink setup
|
|
320
|
+
mach deeplink setup
|
|
321
321
|
```
|
|
322
322
|
|
|
323
|
+
Pass `--base-url` to use a different host. A selected host is compiled into the mobile app, so changing from the Mach address to a customer domain later requires rerunning setup and shipping a new native build.
|
|
324
|
+
|
|
323
325
|
Command flags always override values read from `mach.config.json`; config values are used as defaults.
|
|
324
326
|
|
|
325
327
|
For CI or explicit overrides:
|
|
@@ -341,7 +343,7 @@ mach deeplink setup \
|
|
|
341
343
|
--output public
|
|
342
344
|
```
|
|
343
345
|
|
|
344
|
-
`setup` writes compact `deepLinks` settings into `mach.config.json`, generates Apple AASA and Android `assetlinks.json` files, wires an Expo config plugin for Expo projects, and safely patches Flutter's Android manifest plus iOS entitlements/URL scheme. When the project is linked and has a Mach-managed Android keystore, setup reads its public SHA-256 signing fingerprint automatically; the temporary keystore file is removed immediately. It then offers an optional Google Play App Signing SHA-256 field, defaulting to No. The field accepts comma-separated fingerprints and `assetlinks.json` supports more than one, so debug, direct-distribution, and Google Play builds can coexist. Developers can also add the Google Play value later with a repeatable `--android-fingerprint` flag or `deepLinks.android.sha256CertFingerprints`; it must remain the Play certificate rather than the upload-key certificate. Re-running setup is idempotent. The interactive flow can also enable iOS Web Credentials for HTTPS OAuth callbacks and Android Login Credentials for website password and passkey sharing; both remain disabled by default. For Expo apps, Mach prefers `@radhya/mach/expo-plugin`; interactive setup offers to install `@radhya/mach` locally, and `--yes` or `--install-plugin` installs it automatically. Use `--no-install-plugin` to skip package installation; if the package is missing, Mach generates a local `./plugins/withMachDeepLinks` fallback. See [Deep Links](docs/deep-links.md).
|
|
346
|
+
`setup` writes compact `deepLinks` settings into `mach.config.json`, generates Apple AASA and Android `assetlinks.json` files, wires an Expo config plugin for Expo projects, and safely patches Flutter's Android manifest plus iOS entitlements/URL scheme. `mach web deploy` includes those generated association files in every web release, even when setup wrote them to a separate `public` or `deep-links` directory. When the project is linked and has a Mach-managed Android keystore, setup reads its public SHA-256 signing fingerprint automatically; the temporary keystore file is removed immediately. It then offers an optional Google Play App Signing SHA-256 field, defaulting to No. The field accepts comma-separated fingerprints and `assetlinks.json` supports more than one, so debug, direct-distribution, and Google Play builds can coexist. Developers can also add the Google Play value later with a repeatable `--android-fingerprint` flag or `deepLinks.android.sha256CertFingerprints`; it must remain the Play certificate rather than the upload-key certificate. Re-running setup is idempotent. The interactive flow can also enable iOS Web Credentials for HTTPS OAuth callbacks and Android Login Credentials for website password and passkey sharing; both remain disabled by default. For Expo apps, Mach prefers `@radhya/mach/expo-plugin`; interactive setup offers to install `@radhya/mach` locally, and `--yes` or `--install-plugin` installs it automatically. Use `--no-install-plugin` to skip package installation; if the package is missing, Mach generates a local `./plugins/withMachDeepLinks` fallback. In a multi-app Expo workspace, use one environment-aware wrapper that passes its selected `machConfigPath` to the plugin; Mach will never insert fixed product configuration into the shared root. See [Deep Links](docs/deep-links.md).
|
|
345
347
|
|
|
346
348
|
## Local Device Agent
|
|
347
349
|
|