Do we need a separate Capgo app for every brand?

Only when each brand has its own app ID in the stores. One store app that serves many tenants is one Capgo app with a channel per tenant. Separate branded store apps are separate Capgo apps, each with its own channels.

Can a user switch tenants inside the app?

Yes. If the tenant's channel allows self-assignment, call setChannel() from the app. On current plugin versions the choice is stored on the device and used on the next update check.

What if some tenants are on an older native version?

Use version targeting. Block major updates on a channel, or set a minimum native version on a bundle, so older shells keep a bundle they can run.

Can we roll back one tenant without affecting the others?

Yes. Each channel keeps its own bundle history. Roll the tenant's channel back to an earlier bundle, and the other channels keep what they have.

What still needs a store release?

App names, icons, permissions, native plugins, and native code live in the binary. Capgo Build can build each flavor or scheme and upload it to App Store Connect and Google Play.

白标与多租户应用

用一个代码库发布所有租户的应用

让每个租户、品牌或门店拥有自己的 Capgo channel。更新某个租户的 Web 层时不影响其他租户，并使用 Capgo Build 构建品牌化原生壳。

1 套代码库

每个租户共享同一个 Capacitor App

每个租户 1 个 channel

独立的 bundle、历史记录与回滚

云端 build

Android flavors 与 iOS schemes

终端

Capacitor 应用

租户

通道

原生

Capgo 构建

问题

当每个客户都变成一个分支，白标应用就难做了

品牌变体迅速激增

每个客户都想要自己的 Logo、主题、功能集、内容和上线日期。各自开分支，这些需求就会变成每次发版都要承担的维护成本。

应用商店审核拖慢租户修复

某个租户的菜单错别字或 onboarding 修复，不该等新二进制包和应用商店审核——通常要 24–48 小时，有时更久。

全局发布太一刀切

一次全局更新可能同时搞砸所有品牌。每个品牌单独开分支又会拖慢整个团队。你需要为每个租户提供独立的发布通道。

常见配置

Capgo 应用中的白标方案示例

客户品牌定制的 SaaS 应用

每个企业客户都拥有专属的 Logo、主题、 onboarding 文案和功能集，并通过各自独立的 channel 获取更新。

加盟商或门店应用

每家餐厅、诊所、健身房或分店都可以通过 Live Update 获取本地菜单、素材和活动页面，无需重新发布二进制文件。

小程序市场

宿主应用列出工作区或小程序，并在运行时通过 setChannel() 将设备切换到匹配的 Capgo channel。

解决方案

单一 App Shell，每个租户拥有独立发布通道

Native shell 保持共享，每个租户的 Web 层通过各自的 channel 进行更新。

每个租户专属 channel

每个租户、加盟商或工作区都拥有一个 channel。你可以向单个租户或所有租户发布更新，并能独立回滚某个 channel 而不影响其他租户。

Channels 文档

运行时自行分配

开启自行分配后，App 会调用 setChannel() 将设备加入其租户的 Channel。Capgo 仍会在每次检查更新时验证 Channel。

setChannel() 参考

跨 Shell 的版本定向

租户通常运行不同的 Native 版本。可以按 Channel 阻止大版本更新，或设置最低 Native 版本，让 Bundle 只到达能运行它的 Shell。

版本定向文档

Capgo 为品牌化 Shell 构建

在云端构建每个 Android flavor 或 iOS scheme，并上传到应用商店。对于每周都会变化的 Web 层，使用 Live Updates。

构建选项

工作原理

白标团队如何用 Capgo 交付

一套 Capacitor 代码库，每个租户一个 channel。命令和 code 来自 Capgo CLI 及 updater 文档。

为每个租户创建 channel

每个租户都有自己的 channel、bundle 和历史记录。支持自助分配，让应用能把设备切到该 channel。
```
npx @capgo/cli@latest channel add acme com.example.app --self-assign
npx @capgo/cli@latest channel add globex com.example.app --self-assign
```
Channels 文档
上传每个租户的 bundle

使用租户的主题和配置构建 web 层，然后只上传到该租户的 channel。其他租户的当前 bundle 保持不变。
```
npx @capgo/cli@latest bundle upload --channel acme
npx @capgo/cli@latest bundle upload --channel globex
```
Rollback 文档
登录时将设备切换至所属租户

登录后，调用 setChannel() 并传入该租户的 channel。选择会保存在设备上，并在下次更新检查时生效。
```
import { CapacitorUpdater } from '@capgo/capacitor-updater'

await CapacitorUpdater.setChannel({
  channel: tenant.channel,
  triggerAutoUpdate: true,
})
```
setChannel() 参考
在云端构建品牌化外壳

当租户需要专属的应用商店详情、图标或权限时，使用 Capgo Build 构建对应的 flavor 或 scheme。无需自备 Mac。
```
npx @capgo/cli@latest build request com.acme.app --platform android --android-flavor acme
npx @capgo/cli@latest build request com.acme.app --platform ios --ios-scheme Acme
```
构建选项