# seeg-unity-platform-sdks

**Repository Path**: csseeg/seeg-unity-platform-sdks

## Basic Information

- **Project Name**: seeg-unity-platform-sdks
- **Description**: Seeg Unity 小游戏平台 SDK 原包、固定版本依赖及发行绑定记录
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-09
- **Last Updated**: 2026-10-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Seeg Unity 平台 SDK 资源

本仓库配套 `com.seeg.sdk`，存放每个 Seeg 发行版本的平台依赖绑定记录。官方 Git 依赖继续使用官方仓库的完整提交 SHA；无 Git 的官方原包作为 Release 附件保存。

## 当前状态

`candidates/2.0.3.json` 是本次开发准备的候选清单，尚未成为正式发行绑定。包含微信、快手固定提交和 Bilibili、TikTok、支付宝、京东已校验原包；仅抖音自动下载来源待补齐，记录于 `unavailablePlatforms`。四个平台原包已上传至 Gitee Release，并经匿名下载复核 SHA-256。候选不等同于已发布的 Seeg 2.0.3；已确认 Seeg 2.0.3 有发行分支，因此必须在正式发布前升级源码版本并重新生成候选，不能把本候选作为已发行 2.0.3 的绑定。

原包下载：[Bilibili 新版补充包](https://gitee.com/csseeg/seeg-unity-platform-sdks/releases/tag/bl-20260824-c843ac202d65)、[TikTok 1.1.6-Release](https://gitee.com/csseeg/seeg-unity-platform-sdks/releases/tag/tk-1.1.6-Release)、[支付宝 1.16.26091715](https://gitee.com/csseeg/seeg-unity-platform-sdks/releases/tag/my-1.16.26091715)、[京东 1.1.8-20260920](https://gitee.com/csseeg/seeg-unity-platform-sdks/releases/tag/jd-1.1.8-20260920)。本次按京东 1.1.8 接入要求使用 `WX.ReportGameStart()`，由游戏完成加载并进入核心玩法时调用 `Seeg.TrackLoadComplete(...)` 自动转发，业务无需另行调用平台方法。旧版 1.1.5 附件仍保留。京东原包和官方 `WXTemplate*` 模板名保持不变；平台切换由 Seeg 管理同名模板的隔离与恢复。

Bilibili 新版采用“固定微信 Git SDK + BilibiliMiniGameSdk 补充包 + 本机 CLI 转换”。补充包官方未给出版本号，`20260824-c843ac202d65` 由官方地址日期和 SHA 标识，不是官方语义版本。旧 Bilibili 全量包仍保留在历史合集，供旧绑定使用。

B 站转换工具由用户自行安装，推荐 `pnpm add -g bili-sgame-cli@2.1.22`。SDK 检测本机满足最低 `2.1.13` 的版本后执行；未安装或不满足要求则提示并跳过，不自动下载。`buildTool` 记录推荐和最低版本，实际执行版本记录在构建日志。

支付宝官方提供的原包是 ZIP，里面包含 `ALIPAY-SDK/ALIPAY-SDK-1.16.26091715.unitypackage`。保持原始 ZIP 和校验值，SDK 安装器自动提取指定内包。

## 绑定规则

- 平台原包按 `<平台ID>-<平台版本>` 独立创建 Release（例如 `my-1.16.26091715`、`tk-1.1.6-Release`），方便单独升级、回滚和查找；既有合集附件保留，不破坏旧下载链接。
- 每个 Seeg 版本对应 `bindings/<版本>.json`，与随包 `Editor/SeegPlatformSdks.json` 保持一致。
- Git 必须带完整 40 位提交 SHA，不能使用浮动分支或可移动 tag。官方分支后续变化不会更新已固定依赖；仓库或历史提交被删除则可能无法下载，固定版本不等于异地备份。
- 安装包记录明确版本、官方 URL、SHA-256 和原包文件名，不重新打包。`artifacts/` 仅用于本地准备并被 Git 忽略，原包应上传到固定版本的 Release 附件。
- 只有从实际上传结果取得可下载链接并验证下载 SHA 后，才更新 Seeg 源码中的 URL。不能拼接不存在的镜像地址。
- 发布前从最终源码清单重新准备绑定，提交后以 `seeg-<版本>` tag 发布。既有发行版的绑定和附件不得覆盖；平台升级须随新的 Seeg 版本发布。
- 多个 Seeg 版本可以复用相同平台原包，不要求平台 SDK 版本号与 Seeg 版本号相同。

## 准备原包和清单

在 `seeg-unity` 源码目录执行：

```sh
python3 Tools~/prepare-platform-release.py --output /path/to/staging \
  --archive bl=/path/to/BilibiliMiniGameSdk.unitypackage \
  --archive tk=/path/to/TikTok.unitypackage \
  --archive my=/path/to/AlipaySDKPackage.zip \
  --archive jd=/path/to/JDSDK-20260920.unitypackage
```

先在 staging 生成 `candidates/<版本>.json`、上传原包并核验直链，再更新源码 URL；最后从最终源码向新的 staging 生成最终绑定，审核并确认该 Seeg 版本尚未发布后，将候选提升为 `bindings/<版本>.json` 提交到本仓库。脚本读取 `package.json` 中的 Seeg 版本，检查 Git 提交、原包 SHA 和同版本冲突；不会创建远端仓库、上传、打 tag 或发布 SDK。

不能将带不同内容的绑定写入已有同版本记录。修改尚未发布的候选时使用新的 staging；正式发布后必须提升 Seeg 版本。