Targeting versione
Move Faster With Fewer Surprises
Reduce risk and technical debt. Push updates to specific native versions, roll out changes gradually, and keep older versions stable - all with full control over your update distribution.
Channel Per Native Version
Create a channel for each native build. When you release native version 1.5.0, create a channel for it. All JS updates for that native version go to that channel.
Selective Update Distribution
Push an update to versions 1.3, 1.4, and 1.5 but skip 1.2. Perfect when older native versions can't support new features.
AppFlow Migration Ready
Recreate AppFlow's version-tied channel behavior exactly. Each native build maps to a Capgo channel with the same control you're used to.
Graceful Deprecation
Stop pushing updates to old versions when you're ready to sunset them. Users on old versions stay stable while new versions get updates.
AppFlow Users: Here's Your Migration Path
AppFlow tied bundles to native versions automatically. With Capgo, you get the same behavior with more flexibility:
- 1Create a channel for each native version (e.g., 'native-1.5.0')
- 2Configure your app to use the channel matching its native version
- 3Push bundles to specific channels for targeted distribution
- 4Use our CLI to push to multiple channels at once when needed
// Set channel based on native version
import { CapacitorConfig } from '@capacitor/cli'
import { version } from './package.json'
const config: CapacitorConfig = {
plugins: {
CapacitorUpdater: {
defaultChannel: `native-${version}`,
}
}
}
// Upload to specific version channels
# Push to all 1.5.x versions
npx @capgo/cli bundle upload --channel native-1.5.0
npx @capgo/cli bundle upload --channel native-1.5.1
npx @capgo/cli bundle upload --channel native-1.5.2
# Skip older versions that can't support new features
# native-1.4.x devices stay on their current bundle Common Scenarios
Breaking Native Changes
Native version 2.0 has a new plugin API. Push JS updates that use the new API only to 2.0+ channels.
Gradual Rollout
Test a risky change on your latest native version first. If stable, push to older versions.
Version Sunset
Stop updating native 1.x while continuing to ship to 2.x. Users on old versions stay on their last stable update.
Version-to-Channel Mapping
Each native version points to its own channel for precise update control
Push updates to 2.0 and 1.5 channels only. Users on 1.4 stay stable on their last working bundle.
Need Precise Update Control?
Start targeting updates to specific native versions.