安装教程
全程约 10 分钟。前提：一个能正常访问的 MacCMS v10 站点，服务器 PHP 带 curl、openssl、sodium 扩展（PHP 7.2 以上自带 sodium）。
第一步 · 邮箱注册并领取授权
1
2
领取「插件版」授权码
登录后在「领取授权（免费）」里选 插件版，填你的站点域名（例如 www.yoursite.com），点「领取」。 授权码形如 ADS-XXXXX-XXXXX-XXXXX-XXXXX。
域名要填 APP 实际访问的那个域名，且全平台唯一。默认每个授权绑 1 个域名，换域名重新激活即可。
第二步 · 把插件装进 MacCMS
3
下载并解压到 addons/ads/
在首页下载区下载插件压缩包，解压后把内容放到站点的 addons/ads/ 目录。目录名必须是 ads（插件命名空间是 addons\ads，改名会导致找不到类）。
你的站点根目录/
└─ addons/
└─ ads/ ← 目录名必须是 ads
├─ info.ini
├─ Ads.php
├─ controller/
├─ service/
└─ install.sql也可以在 MacCMS 后台「插件管理 → 本地安装」直接上传 zip。上传方式要求
info.ini 和 Ads.php 在压缩包根目录，我们发布的包已经是这个结构。4
后台启用插件
进 MacCMS 后台 →「插件管理」，找到「ads APP 接口 + 在线打包」，点启用。 启用时会自动建表（前缀_app_*）并生成接口签名凭据。
第三步 · 激活授权
5
打开插件设置页
浏览器访问（需保持 MacCMS 后台登录状态）：
https://你的站点/index.php/addons/ads/admin/index若站点关闭了 PATH_INFO，用 https://你的站点/index.php?s=/addons/ads/admin/index。
6
填授权码激活
在「授权」面板填入上一步领到的授权码，点「激活 / 换绑本站」。插件会带上本站域名向平台激活， 拿到有效期 30 天的签名凭证并本地缓存，之后自动续签；平台短时不可达也有 7 天离线宽限。
第四步 · 在线打包出 APK
7
填写应用信息并提交
同一页面下方「在线打包」面板，填这几项后点「提交打包」：
| 字段 | 说明 |
|---|---|
| 应用名 | 显示在手机桌面的名字，支持中文 |
| 包名 | 形如 com.yoursite.app，全平台唯一，定了就不要改（改包名等于新 APP，老用户无法升级） |
| 版本名 / 版本号 | 如 1.0.0 / 1；每次发新版，版本号必须比上次大 |
| 模板 | 影视、漫画、全能（八合一）三选一 |
| 应用图标 | 正方形 PNG，建议 512×512，最小 192×192 |
首次打包较慢（要下载依赖），之后约 3-5 分钟。任务列表会自动刷新，状态变「成功」后出现「下载 APK」。
第五步 · 立刻备份签名证书
8
导出 .jks 并保存好口令
第一次打包时平台会为你的包名生成一张签名证书，并加密托管。 Android 要求同一个 APP 的升级包必须用同一张证书签名，所以请点「导出签名证书」下载 .jks， 把文件和页面上显示的 storePass / keyPass / alias 一起存好。
证书丢失 = 已安装的用户永久无法覆盖升级，只能换包名重新发一个 APP。导出一次即可，长期有效。