@capgo/capacitor-updater 8.47.5 → 8.47.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 CHANGED
@@ -323,8 +323,8 @@ CapacitorUpdater can be configured with these options:
323
323
  | **`keepUrlPathAfterReload`** | <code>boolean</code> | Configure the plugin to keep the URL path after a reload. WARNING: When a reload is triggered, 'window.history' will be cleared. | <code>false</code> | 6.8.0 |
324
324
  | **`disableJSLogging`** | <code>boolean</code> | Disable the JavaScript logging of the plugin. if true, the plugin will not log to the JavaScript console. only the native log will be done | <code>false</code> | 7.3.0 |
325
325
  | **`osLogging`** | <code>boolean</code> | Enable OS-level logging. When enabled, logs are written to the system log which can be inspected in production builds. - **iOS**: Uses os_log instead of Swift.print, logs accessible via Console.app or Instruments - **Android**: Logs to Logcat (android.util.Log) When set to false, system logging is disabled on both platforms (only JavaScript console logging will occur if enabled). This is useful for debugging production apps (App Store/TestFlight builds on iOS, or production APKs on Android). | <code>true</code> | 8.42.0 |
326
- | **`shakeMenu`** | <code>boolean</code> | Enable shake gesture to show update menu for debugging/testing purposes | <code>false</code> | 7.5.0 |
327
- | **`allowShakeChannelSelector`** | <code>boolean</code> | Enable the shake gesture to show a channel selector menu for switching between update channels. When enabled AND `shakeMenu` is true, the shake gesture shows a channel selector instead of the default debug menu (Go Home/Reload/Close). After selecting a channel, the app automatically checks for updates and downloads if available. Only works if channels have `allow_self_set` enabled on the backend. Only available for Android and iOS. | <code>false</code> | 8.43.0 |
326
+ | **`shakeMenu`** | <code>boolean</code> | Enable the shake gesture while a preview session is active. Outside preview sessions this preview menu is ignored, unless {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector} is enabled. | <code>false</code> | 7.5.0 |
327
+ | **`allowShakeChannelSelector`** | <code>boolean</code> | Enable the shake gesture to show a channel selector menu for switching between update channels. If {@link PluginsConfig.CapacitorUpdater.shakeMenu} is also enabled while a preview session is active, the shake menu includes both preview actions and channel switching. Only available for Android and iOS. | <code>false</code> | 8.43.0 |
328
328
 
329
329
  ### Examples
330
330
 
@@ -1818,19 +1818,15 @@ Use this to:
1818
1818
  setShakeMenu(options: SetShakeMenuOptions) => Promise<void>
1819
1819
  ```
1820
1820
 
1821
- Enable or disable the shake gesture menu for debugging and testing.
1821
+ Enable or disable the shake gesture menu.
1822
1822
 
1823
- When enabled, users can shake their device to open a debug menu that shows:
1824
- - Current bundle information
1825
- - Available bundles
1826
- - Options to switch bundles manually
1827
- - Update status
1823
+ During preview sessions, users can shake their device to:
1824
+ - Reload the current preview
1825
+ - Leave the test app and return to the fallback bundle
1826
+ - Switch update channel, when {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector} is also enabled
1828
1827
 
1829
- This is useful during development and testing to:
1830
- - Quickly test different bundle versions
1831
- - Debug update flows
1832
- - Switch between production and test bundles
1833
- - Verify bundle installations
1828
+ Outside preview sessions, this preview menu is ignored. The channel selector can still be
1829
+ shown outside preview sessions when {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector} is enabled.
1834
1830
 
1835
1831
  **Important:** Disable this in production builds or only enable for internal testers.
1836
1832
 
@@ -1876,12 +1872,9 @@ setShakeChannelSelector(options: SetShakeChannelSelectorOptions) => Promise<void
1876
1872
 
1877
1873
  Enable or disable the shake channel selector at runtime.
1878
1874
 
1879
- When enabled AND shakeMenu is true, shaking the device shows a channel
1880
- selector instead of the debug menu. This allows users to switch between
1881
- update channels by shaking their device.
1882
-
1883
- After selecting a channel, the app automatically checks for updates
1884
- and downloads if available.
1875
+ When enabled, shaking the device can show a channel selector, including outside preview sessions.
1876
+ If {@link setShakeMenu} is also enabled while a preview session is active, the shake menu includes
1877
+ both preview actions and channel switching.
1885
1878
 
1886
1879
  Can also be configured via {@link PluginsConfig.CapacitorUpdater.allowShakeChannelSelector}.
1887
1880
 
@@ -2386,7 +2379,7 @@ Result returned after requesting an immediate native auto-update check.
2386
2379
 
2387
2380
  | Prop | Type | Description | Since |
2388
2381
  | -------------------- | -------------------- | ----------------------------------------------- | ----- |
2389
- | **`id`** | <code>string</code> | The channel ID | 7.5.0 |
2382
+ | **`id`** | <code>number</code> | The channel ID | 7.5.0 |
2390
2383
  | **`name`** | <code>string</code> | The channel name | 7.5.0 |
2391
2384
  | **`public`** | <code>boolean</code> | Whether this is a public channel | 7.5.0 |
2392
2385
  | **`allow_self_set`** | <code>boolean</code> | Whether devices can self-assign to this channel | 7.5.0 |