赞片CMSAPP插件

照着做完，你能把赞片CMS的APP插件从上传安装一路配到真机跑通，并拿到一个能自己打包、自己改接口地址的APP端。

赞片CMS本身是网页端，APP插件的作用是给网站加一层移动端外壳：后台出接口，前端用 uni-app 打包成安卓/iOS 应用。下面按顺序来。

第一步：先确认环境和版本，别急着传文件

这一步要拿到两个信息：你的赞片CMS主程序版本号，以及服务器 PHP 版本。

登录网站后台，看右下角或「系统 → 系统信息」里的版本号，记下来（例如 3.x 系列）。再到服务器面板（宝塔面板 → 网站 → 对应站点 → PHP 版本）确认 PHP 版本。绝大多数赞片CMS的APP插件要求 PHP 7.2 以上，推荐 7.4，PHP 8.0+ 常出现接口报错。

同时确认两件事：

1. 站点已经配置好伪静态（宝塔里选「ThinkPHP」规则）；
2. 根目录有写权限，否则后面装插件会卡在「写入失败」。

注意：插件包必须和主程序大版本对应。拿 2.x 的插件包装到 3.x 上，后台能装进去，但接口会 500，排查半天找不到原因。

第二步：上传插件并完成安装

这一步做完，后台左侧菜单会多出「APP插件」入口。

下载插件压缩包后解压，一般得到两个目录：一个是服务端插件目录（名字类似 zapp 或 appapi），一个是前端 uni-app 源码目录。

用宝塔面板 → 文件 → 进入网站根目录，把服务端插件目录整个上传到插件目录下（赞片CMS通常是 /addons/ 或 /application/，以插件包里的说明文件为准）。上传后在宝塔里右键该目录 → 权限，设为 755，属主设为 www。

然后回网站后台：「应用 → 插件管理 → 未安装插件」，找到插件点「安装」。安装过程中会执行数据表创建，看到「安装成功」即可。

如果后台列表里没出现插件，说明目录名写错了。对照插件包的说明文件改目录名，再刷新页面。

第三步：配置插件参数

安装完成后点插件右侧的「配置」，需要填的内容大致是这几项：

• APP 名称：显示在手机桌面图标下方，建议 4-6 个字，太长会被截断。
• 接口域名：填你的网站域名，必须带 https://，结尾不要加斜杠。
• 签名密钥（AppSecret）：插件会自动生成一串，点「随机生成」，然后复制保存到本地记事本，后面打包前端要用，丢了只能重装插件。
• 版本号与强制更新：首次填 1.0.0，强制更新先关掉，等跑通再开。
• 推送/短信配置：如果插件带推送，需要去对应平台（如个推）建应用，把 AppID、AppKey、MasterSecret 三项填回来。

填完点「保存」，再点一次「测试接口连通」。返回 code: 1 或「连接成功」就说明服务端这头通了。

注意：接口域名如果站点开了 CDN，一定要填源站能正常响应的域名，否则 APP 首次启动会白屏。

第四步：改前端配置并打包成 APP

这一步做完你就得到一个可安装的 apk 或 ipa。

用 HBuilderX（建议 3.8 以上版本）打开插件包里的前端源码目录。找到根目录下的 config.js 或 manifest.json：

• 在 config.js 里把 baseUrl 改成你的接口域名，appSecret 填第三步保存的那串；
• 在 manifest.json → 「基础配置」里填 AppID（DCloud 后台申请）、应用名称、版本号；
• 「图标配置」里上传 1024×1024 的 png 图标，点「自动生成所有图标」。

改完先「运行 → 运行到浏览器」，用手机模式打开，能正常加载首页说明配置对了。再「运行 → 运行到手机或模拟器」，用数据线连安卓手机实测一遍登录、播放、支付。

确认无误后，菜单「发行 → 原生App-云打包」，选安卓，用 DCloud 的公共测试证书先出一个包。测试证书有包名限制，正式上架前要换成自己的证书。

注意：安卓 9.0 以上默认禁止 http 明文请求，接口域名没配 https 的话，真机上是白屏、模拟器上却正常，这是最容易误判的一个坑。

第五步：上线前的检查清单

打包出正式包之前，逐条过一遍：接口域名可公网访问且是 https；签名密钥与后台一致；后台插件里「强制更新」按需开启；APP 启动图和图标已替换（别留着模板默认图）；支付回调地址填的是你站点的域名。

装到两三台不同品牌的安卓机上跑一遍，重点看视频播放和登录态保持——这两个功能最依赖服务器配置。

小结

• 先对版本：主程序大版本和插件包必须匹配，PHP 用 7.4 最稳。
• 三步走：传插件目录 → 后台装 → 填接口域名和密钥，密钥一定要另存。
• 前端用 HBuilderX 改 config.js 和 manifest.json，先浏览器跑通再真机测。
• 白屏九成是 https 或域名填错，先查这两项。
• 正式包务必换自己的签名证书，公共测试证书不能上架。