开始接入
加载 SDK
HTML 中使用固定版本的实际构建产物:
<script src="https://docs.gemigo.io/sdk/0.3.0/gemigo-app-sdk.umd.js"></script>
<button id="login">登录</button>
<script>
document.querySelector('#login').onclick = async () => {
await gemigo.auth.login({scopes: ['identity:basic', 'points:use']});
console.log(await gemigo.points.items());
};
</script>
SDK 的全局变量是 gemigo。浏览器登录需要直接从点击事件触发,允许平台弹窗。点数功能要求已部署在当前应用的 *.gemigo.app 地址;自定义 appId 不能绕过项目身份校验。
已有项目的免费功能不需要点数授权。旧登录仅有 identity/storage 时,重新登录申请 points:use。
使用构建工具
可安装包含 UMD、ES module 和 TypeScript 声明的正式 SDK 包:
npm install https://docs.gemigo.io/sdk/0.3.0/gemigo-app-sdk-0.3.0.tgz
import gemigo from '@gemigo/app-sdk';
当前 0.3.0 托管在文档站,尚未上传 npm registry。
发布你的应用
打开 GemiGo,粘贴 HTML 或上传 ZIP。应用成功部署后,从项目设置进入“点数与收益”,创建收费项,将生成的 itemId 放到 SDK 调用中,再更新部署。
使用命令行:按 CLI Skill 安装并登录现有 GemiGo CLI;不要在 HTML 内保存平台账号、Cookie 或部署令牌。
完成第一次接入
先在钱包领取体验点,从应用按钮发起购买并在平台确认。刷新应用读取 grants,核对解锁仍然有效;在项目设置检查消费记录。