4. SDK 接入准备：注册、拿到钥匙、装包

好了，咱们直接进入实操环节。

你要用这个 SDK，总得先有“入场券”吧？

说白了就三步：注册账号、获取 、安装 SDK 包。

别小看这三步，我在项目里见过太多人卡在最前面——钥匙拿错了，或者包的版本装拧了。咱们一步步来。

4.1 注册开发者账号

不管你是新用户，还是公司团队协作，这一步都一样。

打开浏览器，进入官网的「开发者中心」。点「注册」按钮，填邮箱、设密码、收验证码。嗯，跟你注册任何一个平台账号差不多。

但有几点我特意提醒你：

• 用工作邮箱 —— 我个人习惯用公司邮箱注册，方便团队管理员后续给你授权。
• 密码别太简单 —— 我之前有个项目，同事用了“123456”，结果测试环境被盗刷。虽然不是生产事故，但也挺恶心。
• 注册完马上做二次验证（如果支持）—— 很多平台有 TOTP 或者短信验证，建议直接开。

4.2 获取

登录之后，找到「API 管理」或者「密钥管理」菜单。

你会看到两个关键的东西：App ID 和 。

前者是你的应用唯一标识，后者是调用接口时的签名密钥。两个都不能丢。

创建 Key 的时候，一般会让你选权限范围。我推荐你遵循“最小权限原则”：

• 只勾当前业务需要的检测能力（比如只做兼容性检测，就别开数据上报权限）
• 给 Key 起个名字，过两个月你好知道它是干嘛用的
• 如果可以设置过期时间，那就设一个。到期前再换，安全很多

4.3 安装 SDK 包

拿到钥匙之后，咱们开始装包。这个 SDK 支持 npm 和 yarn 两种主流方式。

用 npm 安装：

npm install @company/browser-compat-sdk --save

用 yarn 安装：

yarn add @company/browser-compat-sdk

跑完命令之后，可以看一眼 package.json 里的 dependencies，确认版本号出现。我一般还会再跑一下这个命令验证：

npm list @company/browser-compat-sdk

如果能看到版本号，说明装好了。

4.4 初始化 SDK

包装好了，就得初始化。一般在应用的入口文件里做这件事。

先导入 SDK，再用你的 App ID 和 去初始化：

import CompatSDK from '@company/browser-compat-sdk';

const sdk = new CompatSDK({
    appId: '你的 App ID',
    : process.env.COMPAT_
});

sdk.init().then(() => {
    console.log('SDK 初始化成功');
}).catch(err => {
    console.error('初始化失败', err);
});

这里有个细节—— 从 process.env 读取，而不是写死。

你想想看，如果哪天你要切换环境（从测试到生产），只需要改环境变量，代码一行都不用动。这个习惯越早养成越好。

4.5 验证安装是否成功

我一直觉得，跑通第一步最有成就感。

初始化完成后，可以调用一个最简单的检测方法试试，比如检测当前浏览器是不是 Chrome：

const result = sdk.detectBrowser();
console.log(result); 
// 输出示例：{ name: "Chrome", version: "120.0.0", supported: true }

如果你能看到类似的结构，说明 SDK 已经工作了。

嗯，这步很重要。跑完第一步，你就成功了一半，是不是？

这个流程图你看一眼——从左到右，从上到下。注册 → 取 Key → 装包 → 初始化 → 验证。每一步都有前一步的依赖。你要是跳过注册直接装包，拿到 Key 也没地方用。反过来，你有了 Key 但没装包，那更是白搭。

准备好了吗？那咱们 SDK 就算真正接进来了。