Skip to content

切换到国服(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 BaseURLhttps://api.xtool.comhttps://api.makeblock.com
默认语言enzh
语言模式多语言(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}prodprod_cn 是两个相互独立的 SDK 实例,同一应用内不要混用。
  • 默认是美服:不传 env(或传 'prod')即接入美服;接入国服必须显式传 'prod_cn'
  • 登录态:两区都从共享域 utoken Cookie 恢复登录态,机制一致(见 SDK 初始化)。

另见:SDK 初始化 · Language 模块 · TypeScript 类型定义

MIT Licensed