# 离线模式快速入门
本文将指导您如何为小游戏接入离线模式，让玩家可以在无网络环境下启动和运行游戏。
# 开通离线模式
# 开通入口
- 登录 TapTap 开发者平台 (opens new window)
- 进入小游戏管理页面，找到「开放能力」
- 点击「离线模式」Tab
注意：离线模式功能需要白名单开通，如未看到该入口，请联系商务申请开通。
# 上传包体流程
开通离线模式后，上传包体流程调整为分步式操作：
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 第一步 │ │ 第二步 │ │ 第三步 │
│ 配置版本信息 │────>│ 上传离线资源 │────>│ 设置分包及自测 │
└─────────────────┘ └─────────────────┘ └─────────────────┘
# 第一步：上传包体与版本设置
上传小游戏包体文件，配置版本相关信息。
# 包体上传
- 点击上传区域或拖拽文件上传小游戏包体
- 等待包体解析完成
- 支持重新上传或删除已上传的包体
# 版本设置
| 配置项 | 说明 |
|---|---|
| 该包体对应版本号 | 必填，仅高版本可覆盖更新低版本，若版本号低于当前版本，则无法正常更新 |
| 该包体最低支持小游戏库版本 | 必填，低于指定库版本将无法正常运行该游戏，将提示用户更新 TapTap |
# 下一步条件
满足以下条件后，「下一步」按钮可点击：
- 包体解析完毕且通过
- 版本设置内容配置完毕
点击「下一步」后：
- 已开通离线模式：进入第二步（上传离线资源）
- 未开通离线模式：跳过第二步，直接进入第三步
# 第二步：离线资源文件上传
此步骤仅在开通离线模式后显示，未开通则自动跳过。
资源包一般是指传递到CDN上的游戏资源包。如果开通离线模式，需要将资源传递到TapTap提供的OSS服务中，OSS服务需要寻找商务同学开启。
| 配置项 | 说明 |
|---|---|
| 离线资源 | 一般是指传递到CDN上的游戏资源包，如果没有使用，可以在平台上选择跳过。 |
| 资源调用路径 | 必填，需要讲离线资源上传 TapTap 提供的 OSS 服务中，格式为 oss://tap-miniapp-3rdparty-bj/{appid}/{游戏名}/{版本号}/，该目录需要与当前的小游戏版本对应。 |
# 资源类型选择
根据小游戏的资源加载方式，选择对应的选项：
| 选项 | 说明 |
|---|---|
| 当前小游戏未使用任何 CDN 下载游戏资源 | 所有内容均已打包在游戏包体中 |
| 当前小游戏存在资源下载逻辑 | 在游戏过程中会逐步加载所需资源 |
# 离线资源配置
路径格式示例：oss://tap-miniapp-3rdparty-bj/2749271/hammer/v1.0.0/
# 编辑框管理
- 离线资源数量：最少 1 个，最多 2 个
- + 添加更多离线资源：当仅存在 1 个编辑框时显示，点击新增编辑框
- 删除：当存在 2 个编辑框时显示，点击删除当前编辑框及内容
# 离线资源校验
配置完资源路径后，需要进行离线资源校验：
| 状态 | 说明 |
|---|---|
| 未校验 | 初始状态，需点击「立即校验」进行校验 |
| 校验中 | 正在校验离线资源是否符合规范 |
| 校验完成 | 校验通过，可进行下一步操作 |
提示：请先完成离线资源校验，再进行下一步测试操作。校验过程中，我们将会检查您的离线资源是否符合规范，并为其生成完整的文件索引目录。
# 下一步条件
满足以下条件后，「下一步」按钮可点击：
- 当前所有内容已填写
- 离线资源校验通过
# 第三步：分包管理与包体自测
# 自测码
根据离线模式和分包功能的开启状态，显示不同的自测码，开发者使用自测二维码开启测试。
# 自测时长要求
- 提示信息：请至少分别测试 10 分钟以上
- 测试时长不足：iOS 及 Android 有任一类型设备，未测试 10 分钟及以上
- 测试时长达标：iOS 及 Android，均存在设备，测试 10 分钟及以上
- 刷新按钮：点击后刷新自测时长记录
# 下一步条件
满足以下条件后，「下一步」按钮可点击：
- 自测时长已达到标准
- （若开启分包功能）总分包函数 >= 10%
点击「下一步」后：
- 有未进行的分包：创建分包任务，分包完成后进行自动化测试
- 无未进行的分包：保存信息，提交自动化测试
# 自动化测试
# 测试内容
| 测试类型 | 说明 |
|---|---|
| 常规自动化测试 | 原有测试流程，所有设备正常测试 |
| 离线模式测试 | 随机抽选 1 台设备，以离线模式进行自动化测试 |
# 测试报告
测试报告新增「运行模式」列，显示该设备进行测试时的运行模式。
# 通过条件
- 离线模式测试通过
- 其他设备测试均通过
# 常见问题
# 如何申请开通离线模式？
离线模式功能需要白名单开通，请联系商务或通过工单系统申请。
# 离线资源路径格式是什么？
资源调用路径格式为 oss://tap-miniapp-3rdparty-bj/{appid}/{游戏名}/{版本号}/，例如：oss://tap-miniapp-3rdparty-bj/2749271/hammer/v1.0.0/
# 自测时长不足怎么办？
请确保在 iOS 和 Android 设备上分别测试至少 10 分钟以上，测试完成后点击刷新按钮更新时长记录。
# 离线模式测试失败会影响发布吗？
是的，离线模式测试必须通过才能发布。如果离线模式测试失败，请检查离线资源配置是否正确。
# 如何关闭已开通的离线模式？
请通过「联系我们」跳转至工单系统申请关闭离线模式功能。