ANDROID APK EDITOR · 智改工坊
安卓修改大师智改工坊
只需说话,就能让应用变成你想要的样子。把反编译、改代码、回编、对齐、签名这条长链路,收进一句中文需求里。
查看智改工坊产品介绍 →陈姐在湖滨路开茶楼开了很多年,第一家店只有六张桌子,门口一棵老樟树,夏天把桌子摆到树下,客人一坐就是一下午。后来生意稳了,她在老街盘下一间带天井的老宅,又在新城的商场里拿了铺位,三家店分别叫湖滨店、老街店、新城店。三家店的菜单不完全一样:湖滨店主打龙井和手工茶点,老街店多几样本地小吃,新城店在商场里,出餐要快,茶点提前做好,客人坐下就能上。
三家店都有点单平板。平板立在收银台边,客人坐下,服务员拿过去,点茶、点茶点、加份小吃,确认后单子直接进后厨。这套东西不是大系统,是陈姐几年前找一个小工作室做的,包名 com.yunqi.order,应用名就叫“云栖点单”。它没有会员体系,没有复杂的库存,只有一个菜单、一个购物车、一个“呼叫服务员”按钮,还有一张门店信息页。够用,也不复杂。
问题出在“三家店共用一个包”上。应用第一次启动时,会让店员在设置里选门店:湖滨、老街、新城。选完之后,单子带着门店编号发给后台,后厨的打印机按编号取单。这个设计在只有一家店的时候没问题,到了三家店,就变成了一个随时会踩的坑:平板可以选错,人也可以选错。
去年秋天的一个中午,老街店来了一个新服务员。她拿到平板,看到设置页里写着“湖滨店”,以为这是总店默认的,就没有改。那天中午老街店翻了三次台,十二张单子带着湖滨店的编号进了湖滨店的后厨。湖滨店的师傅看到单子上的桌号和自家对不上,以为是系统串了,打电话问老街店。两边对了半天,才发现是平板上的门店选错了。十二张单子要作废重开,客人等得脸色不好,老街店的店长小盛一边道歉一边重新下单。
那天晚上,陈姐把三家店的店长叫到一起,说了一句话:“以后不能再让平板问人‘你是哪家店’,它自己得知道。”这句话听起来像气话,其实是一个很准确的需求:门店不应该是一个可以随手改的设置项,而应该是应用身份的一部分。于是有了后面这件事:三家店,三个包,三个包名,三个应用名,三个渠道标识,一套签名。
这篇记录的就是这个过程。用的工具是安卓修改大师智改工坊,产品全名是安卓修改大师电脑版。它的介绍页在 https://www.apkeditor.cn/ai-version.aspx,官网是 www.apkeditor.cn。它的主张只有一句话:只需说话,就能让应用变成你想要的样子。对陈姐来说,这句话的具体意思是:不用再等外包排期,也不用再靠店员记住“我是哪家店”。
三家茶楼、三块平板和三个不能装错的渠道包一、三家茶楼,三块平板,三个不能装错的包
先把三家店的情况说清楚。湖滨店是总店,十二张桌子,门口还有四张露天桌,午市和晚市都忙,菜单最全,茶点现做,出餐慢一点客人也愿意等。老街店在景区边上,八张桌子,游客多,翻台快,菜单里多了几样本地小吃,下午三点之后人少,店员会关掉一半的灯。新城店在商场三层,十张桌子,周末排队,工作日靠写字楼的下午茶,出餐必须快,茶点提前备好,客人坐下三分钟内要上第一轮。
三家店的平板也不一样。湖滨店用的是一台旧平板,挂在收银台侧面,服务员点单时拿下来;老街店是一台屏幕有划痕的平板,立在柜台角上;新城店是商场统一配的平板,系统比较新,但限制了安装来源,装应用要走商场的设备管理流程。这些差异听起来是小事,落到改包上就是一堆具体问题:旧平板的 Android 版本低,新平板的系统限制多,屏幕比例不一样,后厨打印机的取单方式也不一样。
以前的单包方案,靠的是“门店选择”这一个设置项。它的好处是只维护一个包,改菜单只改一次,三家店都能用;坏处是它把“这家店是哪家店”这件最重要的事,交给了一个可以被随手改动的下拉框。店员忙起来,不会检查;新员工来了,不知道要检查;平板重置之后,设置回到默认值,更没人检查。小盛后来跟我说,那次事故之后,他每天早上开店第一件事,就是看一眼平板上的门店名。这个动作很荒诞:一家店的身份,要靠人每天早上去确认。
多门店的系统,最怕的不是菜单不一样,而是单子进错后厨。菜单错了可以改,单子错了,客人已经等在那里了。
陈姐的需求很明确:每家店一个独立的包,装在那家店的平板上,应用名带店名,包里写死门店编号,店员没有任何地方可以改。这样即使平板拿错了,应用名也写着“云栖点单·湖滨店”,一眼就能看出来;即使店员想改,也找不到设置项。她还要求三家的包用同一套签名,以后更新的时候能直接覆盖,不用卸载重装。卸载意味着平板上的本地数据没了,虽然订单都在后台,但“今日已售罄”的标记、服务员的常用备注、打印机的连接记录都会丢。
这个需求听起来简单,做起来要动三个地方:包名、应用名、渠道标识。包名让系统把三个包当成三个独立的应用;应用名让店员在桌面上认得出;渠道标识让后台知道这张单子该去哪个后厨。三个地方必须一起改,少一个就会出问题。只改应用名,三个包的包名一样,装第二个会把第一个覆盖掉;只改包名,渠道标识还是旧的,单子还是会飞错;只改渠道标识,应用名一样,店员分不清哪个是哪个。
二、渠道包不是改个名字:包名、应用名与渠道标识
“渠道包”这个词在 Android 里没有统一的定义,不同的人有不同的做法。有人把渠道号写进清单的 meta-data,有人写进资源文件,有人直接在代码里判断包名,还有人用不同的签名证书给不同的渠道包签名。云栖这个项目,我们选了最朴素的一种:包名不同、应用名不同、assets/channel.txt 里的渠道标识不同,其他完全一样。
| 项目 | 湖滨店 | 老街店 | 新城店 |
|---|
| 包名 | com.yunqi.order.hubin | com.yunqi.order.laojie | com.yunqi.order.xincheng |
| 应用名 | 云栖点单·湖滨店 | 云栖点单·老街店 | 云栖点单·新城店 |
| 渠道标识 | HUBIN | LAOJIE | XINCHENG |
| 版本名 | 3.0.0 | 3.0.0 | 3.0.0 |
| 版本代码 | 300 | 300 | 300 |
| 发布文件名 | yunqi_hubin.apk | yunqi_laojie.apk | yunqi_xincheng.apk |
包名是应用的身份证。Android 用包名来区分应用,包名相同、签名相同的两个包,会被系统当成同一个应用的不同版本;包名不同,就是两个完全独立的应用,可以同时装在一台设备上。云栖的三个包名都以 com.yunqi.order 开头,后面加门店后缀,既保持了品牌的一致性,又让系统把它们分开。这个命名不是随便定的:后缀用拼音,不用中文,不用数字,避免某些系统在包名里遇到不支持的字符;三个后缀长度接近,看起来整齐,排查问题时不容易看错。
应用名是给人看的。店员在桌面上找应用,第一眼看到的是图标,第二眼是名字。名字里带店名,等于把“我是哪家店”写在脸上。应用名也不能太长,太长会被桌面截断,反而看不清。我们试过“云栖茶事·湖滨店点单系统”,十个字,放在一些桌面上会变成两行,第二行只剩“点单系统”,店名被挤到上面,看起来别扭。最后定成“云栖点单·湖滨店”,七个字,一行放得下,店名在最后,一眼能扫到。
渠道标识是给后台看的。它不显示在桌面上,也不参与应用商店的识别,它只做一件事:告诉后台这张单子属于哪家店。我们把渠道标识写进 assets/channel.txt,文件里只有一行,比如 HUBIN。应用启动时读这个文件,读不到就显示“未配置门店”,并且禁止提交订单。这个“读不到就拒绝”的设计很重要:它宁可让店员发现配置有问题,也不让一张没有门店标识的单子发出去。后台收到没有渠道标识的订单,会直接退回,不会猜是哪家店。
为什么不用包名直接当渠道标识?因为包名是系统层面的东西,应用代码里读包名虽然可行,但一旦以后要改包名,渠道逻辑就跟着变。把渠道标识单独放在一个文件里,包名和渠道解耦,改包名不会影响后台的取单规则,改渠道也不会影响系统对应用的识别。这个设计是我们自己的应用里本来就有的,不是工具带的;工具做的是把这个文件的内容按门店改掉,再把包名和应用名一起改掉。
湖滨店、老街店、新城店,各有各的菜单和节奏三、项目隔离:一个店一个工作目录
三个包不能在一个项目里改。听起来是废话,但真做起来,很多人会把三个渠道包放在同一个工程里,靠复制粘贴改来改去,最后自己也分不清哪个包对应哪家店。电脑版的做法是每个 APK 一个项目,项目目录是一个八位随机字符串,里面有 config.ini、history.ini、source.apk、apktool 工程、build 目录和 pack.log。三个店就是三个项目,各自有各自的源包、工程、历史和产物。
项目隔离的第一个好处是“改错不会串”。湖滨店的菜单里有一道“桂花九曲红梅”,老街店没有;新城店的茶点提前做好,菜单上的“现做”标记要去掉。这些差异如果在一个工程里改,很容易把湖滨店的菜单带到老街店。三个项目分开之后,每个项目只改自己的内容,改完打包,产物在各自的 build 目录里,文件名也不一样,不会拿错。
第二个好处是“历史可追溯”。每个项目的 history.ini 只记这个项目的修改需求,最新一条在最上面,显示序号、时间和需求原文。老街店上个月改过什么,点开项目的历史就能看到;湖滨店上周换过哪张茶点图,也能翻到。三家店的需求混在一起,谁也说不清哪条是哪家;分开之后,历史就是每家店自己的账本。
第三个好处是“项目列表一眼认得出”。项目列表读的是磁盘,显示图标、项目名、应用名、包名、版本和创建日期,带搜索和刷新。三个项目的应用名分别是“云栖点单·湖滨店”“云栖点单·老街店”“云栖点单·新城店”,搜索“老街”就能筛出来。每条右侧有“编辑”“历史”“删除”,删除还有防呆,只允许删项目目录的直接子目录,避免手滑把整个工作目录删掉。
项目命名的建议
项目名里带上店名和用途,比如“云栖-湖滨-点单-3.0.0”,不要只写“新包”“最终版”。项目列表的搜索是按项目名和应用名匹配的,名字越具体,后面越省事。
四、签名一致:覆盖更新能不能成,就看这一件事
三个包用同一套签名,这是陈姐特意交代的。她的理由很朴素:“三家店都是我的,为什么要用三套证书?以后换人维护,三套证书丢一套就麻烦。”这个理由成立,但要注意边界:同一套签名可以签多个应用,每个应用还是独立的;签名相同不代表包名相同,包名不同,系统还是会把它们当成三个应用。签名的真正作用,是让系统确认“这个新包是不是原来那个开发者发的”,从而决定能不能覆盖安装。
云栖用的是自己的 JKS,文件名 yunqi-release.jks,别名 yunqi,口令由陈姐和店长各保管一份,放在不同的地方。电脑版的“设置签名”支持默认签名、JKS/keystore、PEM+PK8、随机签名四种,签名文件从磁盘上挑,设置写进项目配置,之后每次打包直接用,不用重填。三个项目都选同一个 JKS,签名方案默认开 v1、v2、v3,v4 默认关。
这里有一个很容易被忽略的细节:随机签名每次都不一样,不能用于覆盖升级。有人图省事,打包时选随机签名,装到平板上能用,下次更新时系统提示“应用未安装”,因为新包的证书和旧包对不上。这时候只有两条路:卸载重装,或者找回旧证书重新签。卸载重装会清掉应用数据,平板上的“今日售罄”标记、打印机连接记录、服务员的备注都没了。云栖的平板虽然订单在后台,但这些本地状态丢了,第二天开店要重新设置一遍,店员会骂人。
签名一致还包括“同一家店的后续版本必须用同一套证书”。假设湖滨店第一版用 yunqi-release.jks,第二版换了另一套证书,哪怕包名没变,系统也会拒绝覆盖。所以签名文件不能丢,不能随便换,不能每个项目各用一套。我们把这些写进了交付文档:JKS 文件、别名、口令、证书指纹,各留一份;每次打包后打开 pack.log,确认 apksigner verify --print-certs 那一段没有报错,指纹和上一版一致。
版本代码是签名的搭档。签名决定“能不能覆盖”,版本代码决定“系统愿不愿意覆盖”。新包的版本代码低于旧包,系统会拒绝降级;等于旧包,有些系统会提示“已安装相同版本”;高于旧包,才会正常覆盖。三家店的第一版都是 300,后面每次改菜单,版本代码加一,比如 301、302。三个项目的版本代码可以同步,也可以各自递增,但同一家店的版本代码必须一直往上走,不能退。
签名的三条底线
第一,正式包不要用随机签名;第二,JKS 至少备份两份,一份在电脑里,一份离线保存;第三,换签名之前先想清楚旧数据怎么办,卸载重装不是一句“重新登录”就能带过的。
五、实例一:云栖茶事三家门店的渠道包
这是本次交付的主线。三个包从同一个源包出发,包名、应用名、渠道标识、版本代码分别改,菜单内容按门店微调,签名统一用 yunqi-release.jks。三个包分别装在三家店的平板上,应用名带店名,渠道标识写死在 assets/channel.txt 里,店员没有任何地方可以改门店。
以前怎么做
以前是一个包,三家店共用。平板第一次启动时选门店,选完写进本地设置;后台按门店编号分单。这个方案在只有湖滨店的时候没问题,到了三家店,问题一个接一个。新员工不知道要选,平板重置后回到默认,店员忙起来忘了检查,都会导致单子进错后厨。那次十二张单子的事故之后,陈姐让工作室改成“启动时强制选门店,选完不能改”,但工作室说“改起来要重新发版,排期两周”。
工作室也提过另一个方案:做三个独立的包,每个包一个包名,装在不同的平板上。报价按三个包算,改一次菜单三个包都要重新打,每次都要等排期。陈姐算了一笔账:三家店,一年改四次菜单,就是十二次打包,加上临时活动,次数更多。等排期的时间比改菜单的时间还长,店里等不起。
还有一个小问题:工作室做的三个包,签名用的是他们自己的证书,陈姐手里没有。这意味着以后换工作室,新团队拿不到旧证书,三个包都无法覆盖升级,只能卸载重装。陈姐对这件事很在意,她说“店是我的,包也得是我的”。所以这次改版的第一件事,就是把签名换回自己的 JKS。
现在怎么做
我先在电脑版里建了三个项目,源包都是同一个 yunqi_order_2.6.1.apk,项目名分别叫“云栖-湖滨-点单”“云栖-老街-点单”“云栖-新城-点单”。每个项目导入后,aapt 读出图标、应用名、包名、版本、最低与目标 SDK、启动页,确认源包没有问题,再在“设置签名”里选 yunqi-release.jks,填别名和口令,保存。
湖滨店的需求是这样写的:
“把包名改为 com.yunqi.order.hubin,应用名改为「云栖点单·湖滨店」,版本名改为 3.0.0,版本代码改为 300。把 assets/channel.txt 的内容改为 HUBIN。清单里的组件名如果是相对名,先补成完整类名再改包名,避免换包名后找不到类。菜单按附件 1 的内容更新,保留湖滨店现有的茶点和价格展示,不要动其他门店的配置。其他功能和资源不动。”
老街店和新城店的需求结构一样,只换包名、应用名、渠道标识和菜单附件。老街店的附件里多了几样本地小吃,新城店的附件里去掉了“现做”标记,加了一句“商场店出餐较快,茶点以当日供应为准”。三份需求都写了“组件名如果是相对名,先补成完整类名”,这是改包名时最关键的一句。
为什么要在意组件名?Android 的清单里,Activity、Service、Receiver 的名字可以写成完整类名,也可以写成以点开头的相对名。相对名是相对清单里的 package 属性解析的。如果把 package 从 com.yunqi.order 改成 com.yunqi.order.hubin,相对名 .MainActivity 就会解析成 com.yunqi.order.hubin.MainActivity,而代码里的类还在 com.yunqi.order.MainActivity,一装就闪退,报 ClassNotFoundException。云栖的源包是工作室用工具打的,组件名用的是完整类名,所以改包名不会断;但为了稳妥,我还是让 AI 检查了一遍,把任何相对名补成了完整类名。
三个项目分别点“立刻修改”,AI 改完留完成标志,主窗口轮询到就自动打包。打包四步:回编、对齐、签名、校验,产物在各自的 build\signed.apk,全过程写进各自的 pack.log。我勾了“自动保存到桌面”,桌面上多了三个文件:云栖点单·湖滨店_3.0.0_signed.apk、云栖点单·老街店_3.0.0_signed.apk、云栖点单·新城店_3.0.0_signed.apk。文件名带应用名和版本,发给店长时不会拿错。
改完怎么验证
第一步,看包的身份。三个包分别装到三家店的平板上,进系统设置的应用信息,确认包名分别是 com.yunqi.order.hubin、com.yunqi.order.laojie、com.yunqi.order.xincheng,应用名带店名,版本名 3.0.0,版本代码 300。第二步,看渠道标识。打开应用,进“关于”页,确认显示的渠道标识是 HUBIN、LAOJIE、XINCHENG,和门店对得上。第三步,下单测试。每家店用平板点一壶茶、两份茶点,确认后看后厨打印机:湖滨店的单子进湖滨店的后厨,老街店的进老街店,新城店的进新城店;再看后台日志,三条订单的门店编号都对。第四步,看覆盖。在第一版的基础上改一处菜单,版本代码升到 301,重新打包,直接覆盖安装,确认不用卸载、本地设置还在。
这套验证里,第三步最重要。包名和应用名是“看起来对”,渠道标识和下单测试是“真的对”。很多渠道包翻车,不是因为包名没改,而是因为渠道标识没改,或者改了但应用读的是另一个文件。云栖的“关于”页会显示渠道标识,这是给店员和运维看的;后台日志会记录订单的门店编号,这是给技术看的。两边都对,才算过。
渠道标识不是装饰,它决定单子飞进哪家后厨六、二维码:一张贴纸背后的下载链路
三个包打好了,怎么送到三家店的平板上?云栖没有用应用商店,也没有用企业分发平台。原因很简单:这是内部应用,不需要公开上架;三家店各有一块平板,装机量很小;店长不会用复杂的后台,越简单越好。最后选的方案是:把 APK 放到对象存储,生成一个固定的下载链接,再把链接做成二维码,打印成一张贴纸,贴在平板背面或者收银台边。
二维码不是工具生成的。电脑版负责把包打出来、传到云存储;二维码是运营用普通的二维码生成器做的,输入的是云存储上那个 APK 的公开下载地址。这个分工要说清楚,免得有人以为工具自带二维码功能。工具做的是“把包放到一个稳定的地址”,二维码只是把这个地址变成一张可以扫的图。
地址必须稳定。云栖的做法是:每个门店一个固定文件名,湖滨店 yunqi_hubin.apk,老街店 yunqi_laojie.apk,新城店 yunqi_xincheng.apk,放在对象存储的同一个目录下。每次发版,上传的新包覆盖同名文件,链接不变,二维码不用重印。如果文件名带时间戳,比如 yunqi_hubin_20261118.apk,每次发版都是一个新地址,二维码就要重新生成、重新打印、重新贴,三家店三张,运营会疯。
平板怎么扫?旧平板没有扫码应用,店员用浏览器打开二维码里的链接,浏览器下载 APK,下载完成后点安装,系统安装器弹出,确认覆盖安装。新平板有扫码功能,直接用相机扫,跳转到浏览器,步骤一样。第一次装的时候,平板上可能还装着旧的单包应用 com.yunqi.order,新包的包名不同,会作为另一个应用安装,不会覆盖旧包。装完确认新应用能下单,再把旧包卸载,避免店员点错。
二维码贴在哪里?湖滨店贴在收银台侧面,老街店贴在柜台角上,新城店贴在平板背面的保护壳里。三张二维码都是塑封的,防油防潮。贴纸上印了一行小字:“扫码更新点单应用,装完请确认店名。”这句话是给小盛加的,他说“不写这句话,新来的店员不知道扫了干嘛”。
二维码也有失效的时候。对象存储的 Bucket 如果是私有读,下载链接会带签名参数,过一段时间就过期,二维码扫出来是 403。云栖的发布目录设成了公共读,里面只放安装包,不放任何订单数据、客户信息或者后台地址。这个设置是在云控制台做的,不是工具做的;工具只负责用 AK/SK 把文件传上去。
二维码的稳定,不是因为它是一张好图,而是因为它背后的文件名一直没变。文件名一变,二维码就是一张废纸。
发布目录、对象存储和一张不会过期的二维码七、云存储:把发布目录搬到店里够得着的地方
云栖用的是阿里云 OSS。选择原因很实际:陈姐的记账软件已经在用阿里云,账号是现成的,加一个子账号就能管这个 Bucket;店里的网络访问阿里云比较稳;OSS 的网页控制台能看到文件的上传时间,店长不用学新东西。电脑版的循环打包支持九种发布方式:阿里云 OSS、亚马逊 S3、腾讯云 COS、华为云 OBS、百度云 BOS、Minio、金山云 KS3、七牛云、FTP。选哪个,任务设置窗口就显示哪个的字段。
| 发布方式 | 主要字段 | 适合的场景 |
|---|
| 阿里云 OSS | Endpoint、Bucket、AK、SK | 国内门店多、已经在用阿里云 |
| 腾讯云 COS | Endpoint、Bucket、AK、SK、Region | 微信生态、腾讯云用户 |
| 华为云 OBS | Endpoint、Bucket、AK、SK | 华为云用户、政企环境 |
| 百度云 BOS | Endpoint、Bucket、AK、SK | 百度云用户 |
| 亚马逊 S3 | Endpoint、Bucket、AK、SK、Region | 海外节点、AWS 用户 |
| Minio | Endpoint、Bucket、AK、SK | 自建对象存储、内网环境 |
| 金山云 KS3 | Endpoint、Bucket、AK、SK | 金山云用户 |
| 七牛云 | Endpoint、Bucket、AK、SK | 静态资源加速 |
| FTP | 主机、端口、用户名、密码、目录 | 老服务器、虚拟主机 |
云栖的目录结构很简单:Bucket 里一个 yunqi 目录,下面一个 release 目录,三个门店的 APK 都放在 release 下。发布目录在电脑上是 D:\AiApkEditor\publish\yunqi,打包产物先复制到这里,再上传到 OSS。任务设置里的“发布目录”可以选本地文件夹,不存在会自动创建;“发布文件名”填前缀,比如 yunqi_hubin,扩展名默认 .apk,窗口里会实时预览下一个文件名。
上传之前,先做一次“测试上传”。任务设置窗口里有一个“测试上传”按钮,选任意一个文件,用当前的云存储参数真正传一次。测试上传按原文件名传,不复制到发布目录,不推进文件名计数器。这个动作看起来多余,其实很值:AK/SK 填错、Bucket 名字打错、Region 选错、子账号没有写权限,都会在这一步暴露,而不是等到半夜循环打包跑到一半才报错。云栖第一次配置的时候,测试上传报的是 AccessDenied,查了半天,发现子账号只给了读权限,没给写权限。加上写权限之后,一次就过。
AK/SK 的保管要单独说。循环打包的任务参数存在项目目录的 loop_task.ini 里,AK/SK 是本机明文保存的。这意味着两件事:第一,项目目录不能随便发给别人,尤其是打包后的压缩包;第二,如果电脑丢了或者项目目录被拷走,要去云控制台把这对 AK/SK 禁用,重新生成一对。云栖的做法是给这个工具单独建一个子账号,只授权 yunqi/release 这个目录的读写,不给整个 Bucket 的权限,也不给其他云资源的权限。这样即使密钥泄露,损失也可控。
八、循环打包:试营业两周,菜单改了七版
渠道包是“一次改好,偶尔更新”的节奏。菜单一年改四次,临时活动不多,三个项目分别打包、分别上传,工作量可以接受。真正需要循环打包的是另一个应用:茶点礼盒的预购应用。
云栖在中秋前推茶点礼盒,四档礼盒,六种搭配,可以到店自提,也可以让跑腿送。礼盒的库存每天变,今天哪一种卖完了,明天哪一种补上了,取货时间也会根据后厨的出炉时间调整。以前的做法是印一张礼盒单,卖完一种就用笔划掉;后来改成在微信群里发图片,图片每天更新,店员保存到相册,客人问起来就翻图片。这个办法的问题是:图片会被刷上去,店员找不到最新那张;划掉的单子客人看不清楚;不同店的库存不一样,群里发的是总仓的图,店里还要自己改。
礼盒预购应用是陈姐让工作室顺手做的,包名 com.yunqi.gift,应用名“云栖茶事·茶点礼盒”,版本 1.8.0。它的页面很简单:礼盒列表、规格、售价展示、售罄状态、取货时间、预购登记。预购登记存在平板本地,后台每天导出一次。这个应用不需要登录,不需要支付,店员用它给客人看礼盒、记预购,客人到店付钱。
试营业两周,礼盒的搭配改了七版。第一版只有四种,第二天加了一种“桂花龙井加茶点”的组合,第三天有一种原料没到货,把其中一款标成售罄,第五天取货时间从下午三点改到四点,第七天又加了两款。每一版都要重新打包、重新上传、重新让三家店的平板更新。如果手动做,运营每天晚上要重复七次“改内容、打包、上传、通知店里”,很容易漏掉一家店。
这就是循环打包的用武之地。电脑版的详情页有一个“保存参数设置”面板,勾选“循环打包去毒”之后,右边出现“任务设置”。任务设置里可以配发布目录、发布文件名、发布方式、任务调度。云栖的配置是:发布目录 D:\AiApkEditor\publish\gift,发布文件名固定为 yunqi_gift.apk,发布方式阿里云 OSS,调度选“打包并上传结束后等待 600 秒再通知 AI 开始下一轮”。固定文件名的原因是二维码:礼盒应用的二维码贴在收银台上,链接不能变,文件名一变,二维码就废了。
循环开始前,运营把当天的最新内容写进项目目录的 gift_today.txt,图片按约定命名放进 gift_images 目录。需求里写的是:
“以工作目录下的 gift_today.txt 为准,更新礼盒列表、规格、售价展示、售罄状态和取货时间;图片按 gift_images 里的文件名对应替换;版本代码在当前基础上加一;其他功能和页面不动。”
点“立刻修改”之后,第一轮开始:AI 读文件、改页面、留完成标志,主窗口自动打包,按任务设置复制到发布目录、改名为 yunqi_gift.apk,上传到 OSS,然后等 600 秒,通知 AI 开始下一轮。运营在这十分钟里可以继续改 gift_today.txt,下一轮 AI 会读到新内容。第一轮会写 history.ini、扣一次大师币;后面的轮次不再写历史、不再扣币。这个细节是工具的设定,运营不用管,但知道之后会觉得合理:循环任务只算一次“修改”,后面是同一任务的延续。
循环任务不是无人值守到没人管。打包窗口在循环期间一直开着,左下角有“停止任务”;AI 等候窗口里的“取消修改”会变成“停止任务”,点了会同时停掉 AI 的生成和循环。详情页取消勾选“循环打包去毒”也等于停止这个项目的循环,别的项目勾选状态变化不会误停。云栖的运营一般跑六轮,从下午两点到三点,最后一轮上传完,扫一遍二维码确认,再点停止。如果中途打包失败、上传失败或者 AI 等待超时,循环会自动停止,原因写在详情页和打包窗口里,不会静悄悄地卡住。
循环打包的适用边界
循环打包适合“内容每天变、文件名要固定、店里要随时拿到最新版”的场景,不适合“改一次就长期不动”的渠道包。三家店的渠道包一年改几次,手动打包更清楚;礼盒应用每天变,循环打包才划算。
九、实例二:茶点礼盒预购应用,固定文件名与覆盖更新
礼盒应用是这次交付的第二个实例。它和三家店的渠道包不同:渠道包是“一个店一个包”,礼盒应用是“一个包,三家店共用”,但礼盒应用没有门店选择,它的预购登记会带一个“登记门店”的字段,由店员在登记时选,默认值是平板所属的门店。这个字段只影响预购记录的归属,不影响礼盒内容;礼盒内容是总仓统一的,三家店看到的一样。
以前怎么做
以前礼盒内容变了,运营要联系工作室,工作室改完打包,发一个 APK 到群里,三家店的店长分别下载、安装。工作室按次收费,改一次等一天,遇到周末更慢。店里等不及,就先用纸质单顶着:打印一张礼盒列表,卖完一种用笔划掉,客人问“这个还有吗”,店员看一眼纸,说“没了”。纸质单的问题很多:字小,客人看不清;划掉之后页面很乱;不同店的库存不一样,总仓的纸单传到店里,店里还要自己改;到了晚上,纸单上的价格和取货时间和实际对不上。
现在怎么做
现在礼盒应用有了自己的项目,项目名“云栖-礼盒-预购”,源包 yunqi_gift_1.8.0.apk,签名用同一套 yunqi-release.jks。运营每天下午把最新的礼盒内容写进 gift_today.txt,格式是“礼盒名称 / 规格 / 售价展示 / 库存状态 / 取货时间”,图片按 gift_images/礼盒名_序号.jpg 命名。然后打开项目详情页,勾选“循环打包去毒”,点“任务设置”,确认发布文件名是 yunqi_gift.apk,点“测试上传”确认 OSS 能写,再点“立刻修改”。
第一轮跑完,运营扫二维码,下载,安装,看三件事:礼盒列表是不是今天的,售罄状态对不对,取货时间是不是新的。确认之后,让循环继续跑。后面每一轮,运营只改 gift_today.txt 和图片,不再点“立刻修改”;AI 按同一段需求继续读文件、改页面,打包上传。六轮跑完,最后一版就是当天晚上的最终版,三家店的平板扫码就能装。
改完怎么验证
第一步,看覆盖。平板上原本装着 1.8.0,新包直接覆盖,系统没有提示签名不一致;打开应用,之前登记的预购记录还在,说明包名和签名都没变。第二步,看内容。礼盒列表、规格、售价展示、售罄状态、取货时间,逐项对照 gift_today.txt;图片有没有换对,尤其是礼盒的包装图,不能把 A 礼盒的图放到 B 礼盒上。第三步,看版本。应用信息里的版本代码比上一版高,版本名即使沿用 1.8.x,版本代码也逐版递增,运营能对上今天是第几版。第四步,看后台。三家店各登记一条测试预购,后台导出的记录里,门店字段、礼盒名称、取货时间都对。
覆盖安装是这一步的核心。礼盒应用的预购记录存在本地,如果签名不一致或者包名变了,系统会要求卸载重装,本地的预购记录就没了。运营在试营业期间最怕这个:客人已经登记了,店员说“应用要重装,记录没了”,客人会要求退款。所以签名和包名从第一版就定死,后面只改内容,不改身份。版本代码每次加一,保证系统认为是新版本;版本名可以带日期,方便运营对照,但版本代码才是系统真正比较的东西。
回滚也要提前想好。如果某一版礼盒内容改错了,比如把售罄的礼盒标成有货,店里卖了,客人到店取不到,这时候不能把旧包直接降级覆盖,因为系统可能拒绝降级。更稳的做法是:保留上一版的 signed.apk 在本地 archive 目录,改回正确的内容,版本代码再加一,重新打包上传。这样系统看到的是更高的版本,正常覆盖;店里扫码拿到的是修复版。电脑版在安装失败处理里支持“允许降级覆盖”,遇到 VERSION_DOWNGRADE 时可以应急,但那是最后手段,不是常规流程。
平板立在收银台边,扫码、下载、覆盖安装,一分钟完成十、验收清单与六个常见坑
这个项目做完,我整理了一份验收清单,三家店的店长和运营各留一份:
- 每家店的包名、应用名、渠道标识与门店对照表一致。
- 三个包都用
yunqi-release.jks 签名,pack.log 里的证书指纹一致。 - 版本代码比平板上已装的版本高,覆盖安装不提示降级。
- 每家店下单测试,后厨打印机收到的是本店订单,后台日志的门店编号正确。
- 二维码指向的地址能下载,文件大小与刚上传的包一致。
- 云存储上的固定文件名被覆盖,最后修改时间是本次上传时间。
- 循环任务能正常停止,第一轮之后不再重复写历史、不再重复扣币。
- 上一版 APK 在本地
archive 目录留有备份,回滚步骤写在交付文档里。
六个常见坑,按出现频率排:
| 现象 | 常见原因 | 先做什么 |
|---|
| 单子飞进别家后厨 | 渠道标识写错,或应用读的是另一个文件 | 看 assets/channel.txt 和“关于”页的渠道标识 |
| 装上一点就闪退 | 改包名时组件名还是相对名 | 把组件名补成完整类名,重新打包 |
| 覆盖安装提示“应用未安装” | 签名与旧版不一致 | 换回同一 JKS,不要急着卸载 |
| 提示降级 | 版本代码没升,或比旧版低 | 升版本代码,重新打包 |
| 扫码下载的还是旧版 | 文件名带时间戳,或浏览器缓存 | 固定文件名,刷新页面或换下载工具 |
| 上传失败 | AK/SK 错、Bucket 名错、子账号没写权限 | 先用“测试上传”验证,再看错误信息 |
十一、用户评价:店长、后厨与老板真正在意的事
“以前一个店出错,三个店一起挨骂。现在每个店一个包,后厨看渠道码,我心里踏实。”
—— 陈姐 · 云栖茶事创始人
“我们店十二张桌子,午市最忙的时候,平板上的单子直接进后厨,不用再喊。”
—— 阿良 · 湖滨店店长
“老街店只有八张桌子,游客多,菜单换得勤。现在我自己扫码更新,不用等总部。”
—— 小盛 · 老街店店长
“商场店最怕客人等。扫码更新一分钟,客人坐下就能点。”
—— 阿May · 新城店店长
“渠道包的关键不是技术,是责任边界。哪个店的单子进哪个后厨,这件事不能靠人记。”
—— 老周 · 餐饮系统顾问
十二、收尾:三家店,三个图标,一条看不见的链路
中午十一点半,湖滨店的第一批客人坐下。服务员从收银台拿起平板,屏幕上是一枚茶盏图标,下面写着“云栖点单·湖滨店”。她点开应用,首页是今天的菜单,第一行是“龙井”,第二行是“桂花九曲红梅”。客人点了一壶龙井、两份茶点,她确认,后厨的打印机响了一声,单子出来了。几乎同一时间,老街店的小盛在柜台角上拿起另一块平板,屏幕上写着“云栖点单·老街店”,他给一桌游客点了几样本地小吃。新城店的阿May在商场三层,平板立在收银台边,屏幕上写着“云栖点单·新城店”,她扫了一眼今天的售罄标记,把平板递给客人。
三家店,三个图标,三个包名,三个渠道标识,一套签名。客人看不到这些,他们只看到菜单、茶点和上菜的速度。店员也看不到这些,他们只看到桌面上的店名和扫码更新的贴纸。只有后厨的打印机和后台的日志知道,每一张单子都带着一个看不见的渠道标识,从哪块平板出发,进了哪家店的后厨。
这就是渠道包的价值:它不炫技,也不复杂,它只是把“我是哪家店”这件事,从一个人的记忆里,搬到应用的身份证里。安卓修改大师智改工坊把这个过程收进一句中文需求里:改包名、改应用名、写渠道标识、统一签名、打包、上传到一个稳定的地址,剩下的交给二维码和店里的平板。它的介绍页在 https://www.apkeditor.cn/ai-version.aspx,官网是 www.apkeditor.cn。只需说话,就能让应用变成你想要的样子——这句话在云栖这里,具体成了“三家店,三个包,单子不再飞错后厨”。
如果你也在经营多门店的生意,不妨先画一张表:每家店的包名、应用名、渠道标识、签名、版本代码、发布文件名。表画清楚了,改包只是照着表填;表没画清楚,改得越快,错得越远。技术的作用不是让人变得更忙,而是让那些本来要靠人记住的事,变成应用自己知道的事。
合规提醒
本文涉及的改包操作均针对自有版权或已获授权的应用,仅用于学习、研究、内部测试与正式交付。请勿修改他人付费应用、破解付费内容或绕过安全机制。改包前请确认授权范围,改包后请保留源包与日志。
安卓修改大师智改工坊 · https://www.apkeditor.cn/ai-version.aspx
DOWNLOAD
安卓修改大师智能修改安卓版
手机、平板直接安装,导入 APK 后说一句话,自动反编译、修改、回编、对齐、签名;也能把网址打包成应用,成品可装、可存、可分享。
立即下载安卓版 / 查看详情 →官网 www.apkeditor.cn · 请仅修改自有版权或已获授权的应用