切换到国服(China Region)
SDK 默认接入美服(env 不传 → 'prod' → https://api.xtool.com)。要接入国服,只需在初始化时把 env 设为 'prod_cn' —— 这是唯一必须的改动。
一行切换
ts
import { GeneratorSDK } from '@atomm-developer/generator-sdk'
const sdk = GeneratorSDK.init({
appKey: 'your_app_key',
env: 'prod_cn', // 国服
})国服 vs 美服
美服(prod) | 国服(prod_cn) | |
|---|---|---|
| API BaseURL | https://api.xtool.com | https://api.makeblock.com |
| 默认语言 | en | zh |
| 语言模式 | 多语言(URL 前缀 /de/…) | 单语言(锁定 zh) |
语言行为
国服环境下,sdk.language.getCurrentLocale() 默认返回 'zh'(单语言:无 URL 前缀、无浏览器检测)。完整解析优先级见 Language 模块。
配合 generator-workbench
如果你使用 generator-workbench,workbench 的环境由你传入的 SDK 实例派生 —— sdk.getEnv() 是唯一权威来源。所以只要 SDK 用 env: 'prod_cn' 初始化即可:
ts
const sdk = GeneratorSDK.init({ appKey: 'your_app_key', env: 'prod_cn' })
workbench.sdk = sdk
workbench.config = {
sdk,
atommProEnv: 'prod_cn', // 可选;若设置,需与 SDK env 一致
// ...其它配置
}
workbench.mount()- 不传
config.atommProEnv时,workbench 仍会用 SDK 的 env;若传了但与 SDK env 不一致,workbench 会打印告警并以 SDK env 为准。 - 国服环境下 workbench 还会自动应用国服默认:界面默认语言
zh,积分 / 用户中心链接指向www.atomm.com.cn(而非www.atomm.com)。
注意
- 每个区是独立实例:实例缓存键为
{appKey}::{env},prod与prod_cn是两个相互独立的 SDK 实例,同一应用内不要混用。 - 默认是美服:不传
env(或传'prod')即接入美服;接入国服必须显式传'prod_cn'。 - 登录态:两区都从共享域
utokenCookie 恢复登录态,机制一致(见 SDK 初始化)。
另见:SDK 初始化 · Language 模块 · TypeScript 类型定义