# 1. 产品介绍
FinClip 是一个小程序运行时 SDK。无论是移动应用，还是电脑、电视、车载主机等设备，在集成 FinClip 小程序 SDK 之后，都能快速获得运行小程序的能力。
FinClip 提供了小程序 SDK 与小程序管理后台。开发者可以在自己的 App 中迁移和部署已有小程序，从而获得足够灵活的小程序开发与管理体验。
FinClip 不仅兼容微信小程序语法，还提供了一整套小程序开发与管理工具包。开发者无需学习新的语法与框架，即可使用 FinClip Studio、小程序管理后台、小程序开发文档与 FinClip App，低成本、高质量地完成从开发、测试到预览、部署的全部工作。
FinClip 可以帮助企业快速集成自研及第三方业务应用；协助企业构建超级 App 以实现复杂业务线的松耦合；帮助企业培养平台化的运营思维与组织架构。
# 1.1 POC 目的
本 POC 指南旨在帮助您通过实际操作，了解 FinClip 小程序开放平台管理系统的主要功能与优势。通过此过程，您可以评估该产品是否满足企业的实际需求，产品的真实功能或性能是否与供应商宣传的一致，评估系统与企业业务需求的兼容性，并将其作为采购决策的依据。
# 1.2 POC 目标
本次 POC 的目标是帮助您成功体验 FinClip 小程序开放平台管理系统的核心功能，包括 FinClip 小程序容器 SDK、FinClip 小程序管理后台、FinClip 生态构建、FinClip 小游戏等功能模块。通过此过程，期望帮助您确认项目可行性、评估项目绩效以及评估项目潜力，为后续决策提供重要依据。
# 2. 准备阶段
# 2.1 人员要求
为确保本次 POC 能达到预期目标，需要一支跨职能团队协同工作，因为不同领域的专业知识和技能组合对于提高整体验证工作和项目的可行性至关重要。我们需要您安排以下角色参与测试：
| 序号 | 角色 | 人数 | 职能 |
|---|---|---|---|
| 1 | 项目经理 | 1 | 1. 负责整体项目把控，包括 POC 方案的制定、执行与监控，确保整个 POC 方案的顺利实施并达到预期效果。 2. 负责测试 FinClip 小程序平台核心功能。 3. 负责 POC 体验的组织、汇总、汇报等工作。 |
| 2 | App 开发者 | 2~3 | 1. 负责测试 FinClip 小程序容器 SDK，包括 iOS SDK、Android SDK、PC SDK 等，并输出 SDK 测试报告。 2. 负责输出用于体验、演示、汇报的安装包，包括但不限于 apk、ipa、exe、dmg 等。 |
| 3 | 前端开发者 | 1 | 1. 负责测试 FinClip Studio 小程序开发工具，并输出 FinClip Studio 测试报告。 2. 负责输出一个可体验的小程序，确保该小程序能在 FinClip Studio 上正确运行，并发布到 FinClip 小程序平台的系统管理后台。 |
# 3. 访问系统
您可以通过以下链接访问系统并体验功能
| 网站名称 | 访问链接 | 账号/密码 |
|---|---|---|
| 开发者中心 | https://super-apps.ai/finclip/login/?app_type=dev | 自行注册 |
# 4. 验证步骤
您需要准备以下材料与内容，以完成 FinClip 的 POC 验证。
# 4.1 验证准备
# 4.1.1 账号准备
# 4.1.1.1 注册账号
- ① 进入开发者中心，点击页面中的"免费注册"
- ② 输入手机号、验证码、邮箱，设置登录密码，然后点击"注册"，即可成功注册。
# 4.1.1.2 升级至企业账户
- ① 进入开发者中心，依次点击左下角"用户名 - 升级账户"，进入企业认证页面
- ② 分别填写企业主体信息与管理员信息（测试阶段以下信息不会进行核验，可随意填写，包括企业营业执照等材料）
- ⑤ 提交成功后，会出现提交成功的页面。
- ⑥ 您可以联系 Finogeeks 的 POC 项目经理或商务人员进行审核。
# 4.1.2 登录 FinClip Studio
- ① 下载 请确保您的 FinClip Studio 版本是最新版本 (opens new window)。如果不是，可以下载我们的最新版 FinClip Studio (opens new window)。
- ② 登录账号：输入"章节 4.1.1"中准备好的账号和密码，点击"登录"，即可完成 FinClip Studio 的登录。
# 4.1.3 登录 FinClip App
- ① 下载 iPhone 用户请登录 App Store 搜索「 FinClip 助手 (opens new window) 」下载。Android 用户请点击 「 下载链接 (opens new window) 」 、「Google Play Store」下载最新版本的 FinClip App。
- ② 下载 输入"章节 4.1.1"中准备好的账号和密码/使用手机验证码完成 FinClip App 的登录。操作如下：
# 4.1.4 演示资源
如果您希望获取一些演示资源，可以通过以下方式下载；否则，可跳过此步骤
| 类型 | 名称 | 开发语言 | 下载地址 | 备注 |
|---|---|---|---|---|
| 小程序 | 示例小程序 | 微信原生 | https://gitee.com/finclip/miniprogram-demo | FinClip 示例小程序，可用于测试小程序中相关 API 与组件的能力 |
| SDK | Android SDK | Java | https://gitee.com/finclip/android-demo | Android 演示（实现了初始化、打开小程序、自定义 API 等） |
| iOS SDK | https://gitee.com/finclip/ios-demo | iOS 演示（实现了初始化、打开小程序、自定义 API 等） | ||
| PC SDK | https://gitee.com/finclip/finclip-desktop-demo | PC端演示（实现了初始化、打开小程序、自定义 API 等） |
# 4.2 验证计划
对于 POC 验证过程，先验证主流程有助于在早期发现可能影响整个项目的重大问题。在确认主流程可行性后，再进行功能验证，可以避免在基础流程不可行的情况下浪费资源测试具体功能。因此，本次 POC 的验证计划对主流程的验证进行了详细描述。
# 4.2.1 主流程验证
为确保主流程验证的完整性，在此步骤中，请先使用我们的小程序演示资源。在您的 App 中运行我们的示例代码小程序，确保主流程的完整性，然后替换为您自己的小程序，最后进行相应的功能验证。
# 4.2.2 验证目标
通过 FinClip 小程序开放平台系统提供的能力，在目标软件 App 上正确运行 FinClip 小程序演示。
# 4.2.3 验证流程
# 4.2.4 验证步骤
# 4.2.4.1 创建小程序
| 类别 | 内容 |
|---|---|
| 测试编号 | M0001 |
| 测试项目 | FinClip 小程序平台 - 开发者中心 |
| 测试功能 | 创建小程序 |
| 前置条件 | 在浏览器中打开 FinClip 小程序平台 - "开发者中心"并成功登录。 |
| 测试步骤 | 1. 进入"小程序"目录，点击"新建"按钮，会弹出小程序文本框。 2. 依次填写"小程序名称"、"项目类型：选择小程序"、"分类：选择工具"、"项目简介"、"项目描述"、"图标"等信息，点击"确认"创建小程序。 3. 点击新建的小程序，查看详情，进入"信息详情" - "隐私设置" - "配置"，会弹出小程序数据政策。 4. 选择"不会以任何方式处理用户信息"并点击"确认"。 |
| 预期效果 | 1. 成功创建小程序后，进入"小程序"目录，可以从列表中查看到刚刚创建的小程序。 2. 点击对应小程序可查看其基本信息，包括名称、AppID 等详情。 |
# 4.2.4.2 添加域名/IP 白名单
| 类别 | 内容 |
|---|---|
| 测试编号 | M0002 |
| 测试项目 | FinClip 小程序平台 - 开发者中心 |
| 测试功能 | 添加域名/IP 白名单 |
| 前置条件 | 在浏览器中打开 FinClip 小程序开放平台 - "开发"并成功登录。 |
| 测试步骤 | 1. 进入"开发 - 域名"目录，点击"域名配置"按钮，会弹出域名管理输入框。 2. 在白名单输入框中，输入小程序需要访问的业务域名或 IP，点击"确认"。 |
| 预期效果 | 1. 域名白名单配置成功。导航至"开发 - 域名"目录可查看对应的域名及白名单/黑名单。 |
# 4.2.4.3 创建小程序项目
| 类别 | 内容 |
|---|---|
| 测试编号 | M0003 |
| 测试项目 | FinClip 小程序开放平台管理系统 - FinClip Studio |
| 测试功能 | 创建小程序项目 |
| 前置条件 | 打开 FinClip Studio 并完成登录。 |
| 测试步骤 | 1. 打开 FinClip Studio，点击「+」按钮，会弹出创建小程序页面。 2. 输入「项目名称」、选择「项目目录」、类型选择「小程序」、项目模板选择「模板」，点击右下角的「创建」按钮。 |
| 预期效果 | 1. FinClip Studio 自动创建项目并进行编译。 2. 在 FinClip Studio 中可以预览小程序示例模板。 |
# 4.2.4.4 上传小程序代码包
| 类别 | 内容 |
|---|---|
| 测试编号 | M0004 |
| 测试项目 | FinClip 小程序开放平台管理系统 - FinClip Studio |
| 测试功能 | 上传小程序代码包 |
| 前置条件 | 打开 FinClip Studio 并完成登录。 |
| 测试步骤 | 1. 点击 FinClip Studio 顶部的"上传"按钮，弹出小程序上传页面。 2. 选择 AppID（即步骤 1 中创建的小程序 ID），输入"版本"，输入"描述"，点击"确认"。 |
| 预期效果 | 小程序上传成功，并弹出"上传成功"提示信息。 |
# 4.2.4.5 提交小程序审核
| 类别 | 内容 |
|---|---|
| 测试编号 | M0005 |
| 测试项目 | FinClip 小程序开放平台管理系统 - 开发者中心 |
| 测试功能 | 审核小程序 |
| 前置条件 | 在浏览器中打开 FinClip 小程序开放平台 - "开发"并成功登录。 |
| 测试步骤 | 1. 进入"小程序"目录，点击新建的小程序，查看详情，进入"信息详情" - "版本" - "审核版本"。 2. 按照"提交审核" - "填写审核信息（选填）" - "确认信息" - "下一步" - "确认"的步骤提交审核。 |
| 预期效果 | 在审核版本中，可以查看到审核版本信息及提交信息。 |
# 4.2.4.6 审核小程序
| 类别 | content |
|---|---|
| 测试编号 | M0006 |
| 测试项目 | FinClip 小程序开放平台管理系统 - 开发者中心 |
| 测试功能 | 提交小程序审核 |
| 前置条件 | 在浏览器中打开 FinClip 小程序开放平台 - "开发者中心"并成功登录。 |
| 测试步骤 | 1. 进入「首页」-「待办事项」-「审核状态」，找到上述步骤提交审核的小程序，点击「详情」，弹出小程序审核页面。 2. 检查小程序信息，确认无误后，点击页面底部的「通过」按钮，审核成功。 |
| 预期效果 | 1. 小程序已通过审核，上述待审核小程序将从待办事项列表中移除。 2. 进入"开发者中心"，进入"小程序"目录，点击小程序查看详情，小程序将显示为已通过审核。 |
# 4.2.4.7 发布小程序
| 类别 | 内容 |
|---|---|
| 测试编号 | M0007 |
| 测试项目 | FinClip 小程序开放平台管理系统 - 开发者中心 |
| 测试功能 | 发布小程序 |
| 前置条件 | 在浏览器中打开 FinClip 小程序开放平台 - "开发者中心"并成功登录。 |
| 测试步骤 | 1. 进入<小程序>目录，点击新建的小程序，查看详情，进入<信息详情> - <版本> - <审核版本>，点击<发布到线上版本>，会出现发布弹窗。2. 选择 <全量发布>，点击<确认>，小程序发布完成。 |
| 预期效果 | 刷新页面，小程序状态变为 - 已发布。 |
# 4.2.4.8 创建宿主应用
如果您没有宿主 App，可以跳过此步骤，直接前往章节 4.2.4.12，通过 [方法二] FinClip App 预览小程序。
| 类别 | 内容 |
|---|---|
| 测试编号 | M0008 |
| 测试项目 | FinClip 小程序开放平台管理系统 - 开发者中心 |
| 测试功能 | 创建宿主应用 |
| 前置条件 | 在浏览器中打开 FinClip 小程序开放平台 - "开发者中心"并成功登录。 |
| 测试步骤 | 1. 进入"宿主应用"目录，点击"新建"按钮，会弹出新建应用输入框。 2. 依次填写"应用名称"、"所属组织"、"简介"、"其他团队可见 - 否"、"应用自动关联小程序 - 是"、"上传图标"等信息，点击"确认"创建应用。 3. 进入"宿主应用"目录，点击"宿主应用名称"，进入"BundleID" - "添加 BundleID"，会弹出添加 BundleID 的弹窗。 4. 选择 BundleID 应用平台，此处选择"Android"/"iOS"，输入 App 的 BundleID，点击"确认"完成添加。 |
| 预期效果 | 进入"宿主应用"目录，点击"宿主应用名称"，进入"BundleID"，可以看到新增了一条数据，在此处可以查看 API Server、SDK Key、SDK Secret 等信息。 |
# 4.2.4.9 绑定小程序
| 类别 | 内容 |
|---|---|
| 测试编号 | M0009 |
| 测试项目 | FinClip 小程序开放平台管理系统 - 开发者中心 |
| 测试功能 | 绑定小程序 |
| 前置条件 | 在浏览器中打开 FinClip 小程序开放平台 - "开发者中心"并成功登录。 |
| 测试步骤 | 1. 进入"宿主应用"目录，点击"宿主应用名称"，进入"绑定小程序" - "配置小程序"，会弹出编辑小程序的弹窗。 2. 勾选已发布的小程序，点击"确认"完成小程序关联。 |
| 预期效果 | 进入"宿主应用"目录，点击"宿主应用名称"，进���"绑定小程序"，可以看到新增了一条数据，并查看绑定小程序列表。 |
# 4.2.4.10 集成 SDK
| 类别 | 内容 |
|---|---|
| 测试编号 | M00010 |
| 测试项目 | FinClip 小程序开放平台管理系统 - FinClip SDK |
| 测试功能 | FinClip SDK 集成 |
| 前置条件 | 拥有宿主 App 且具备可运行的源代码。 |
| 测试步骤 | 1. Android App 集成：Android 集成指南 2. iOS App 集成：iOS 集成指南 3. HarmonyOS App 集成：HarmonyOS 集成指南 4. 桌面应用集成：PC 集成指南 更多 FinClip SDK 指南请参考：FinClip SDK 文档中心 |
| 预期效果 | App 成功集成 SDK，集成后代码编译无报错，App 编译打包等流程通过。 |
# 4.2.4.11 初始化 SDK
| 类别 | 内容 |
|---|---|
| 测试编号 | M0011 |
| 测试项�� | FinClip 小程序开放平台管理系统 - FinClip SDK |
| 测试功能 | FinClip SDK 集成 |
| 前置条件 | App 已成功集成 FinClip SDK |
| 测试步骤 | 1. Android SDK 初始化：Android 初始化指南 2. iOS SDK 初始化：iOS 初始化指南 3. HarmonyOS SDK 初始化：HarmonyOS 初始化指南 4. 桌面 SDK 初始化：PC 初始化指南 更多 FinClip SDK 初始化指南请参考：FinClip SDK 文档中心 |
| 预期效果 | FinClip SDK 初始化成功。通过初始化 SDK 的 API 回调信息，返回初始化成功。 |
# 4.2.4.12 打开小程序
| 类别 | 内容 |
|---|---|
| 测试编号 | M0012 |
| 测试项目 | FinClip 小程序开放平台管理系统 - FinClip SDK |
| 测试功能 | FinClip SDK 集成 |
| 前置条件 | 1. 小程序已成功发布。 2. App 已集成 FinClip SDK 并初始化成功。 3. [可选] 已下载并登录 FinClip App |
| 测试步骤 | [方法一] 通过宿主 App 打开小程序 1. Android App 打开小程序步骤：Android 打开小程序指南 2. iOS App 打开小程序步骤：iOS 打开小程序指南 3. HarmonyOS App 打开小程序步骤：HarmonyOS 打开小程序指南 4. 桌面端打开小程序步骤：PC 打开小程序指南 更多使用 FinClip SDK 打开小程序指南请参考：FinClip SDK 文档中心 [方法二] 通过 FinClip App 扫码打开小程序 1. 获取小程序二维码：进入「FinClip 管理后台 - 开发者中心 - 小程序 - 版本」查看二维码。 2. 打开 FinClip App，进入首页，点击二维码扫描按钮，即可打开小程序。 |
| 预期效果 | 在 App 中打开小程序并预览 |
# 5. 参考资料
| 类别 | 资料名称 | 资料链接 |
|---|---|---|
| 开发者中心 | 操作手册 | 操作手册 (opens new window) |
| 操作视频 | 操作视频 (opens new window) | |
| FinClip SDK | iOS SDK 指南文档 | SDK 指南文档 (opens new window) |
| iOS SDK 集成视频 | SDK 集成视频 (opens new window) | |
| Android SDK 指南文档 | SDK 指南文档 (opens new window) | |
| Android SDK 集成视频 | SDK 集成视频 (opens new window) | |
| 桌面端 SDK 指南文档 | SDK 指南文档 (opens new window) | |
| FinClip Studio | 小程序开发指南 | 小程序开发指南 (opens new window) |
| 使用手册 | 使用手册 (opens new window) | |
| 教学视频 | 教学视频 (opens new window) | |
| FinClip App | 操作手册 | 操作手册 (opens new window) |
| 常见问题 | 常见问题 | 常见问题 (opens new window) |
# 6. 总结
感谢您的体验。至此，FinClip 小程序管理平台系统的 POC 主流程测试已完成，您可以继续对 FinClip 小程序管理平台系统进行功能验证。