ANDROID APK EDITOR · 智改工坊
安卓修改大师智改工坊
只需说话,就能让应用变成你想要的样子。把反编译、改代码、回编、对齐、签名这条长链路,收进一句中文需求里。
查看智改工坊产品介绍 →
本地站点打包的成败,往往在第一个相对路径上就已经决定网址打包在界面上只给了两个入口:一个是线上网址,一个是本地网页目录。前者把地址交给内置浏览器,页面随网站更新,断网就打不开;后者把整个站点复制进 APK,装到手机上以后不依赖网络,也不会因为服务器迁移而突然白屏。两种模式没有高下之分,但本地目录模式对“目录结构”和“相对路径”的要求严厉得多,因为没有一个 Web 服务器替你把根路径、默认首页、MIME 类型和 404 兜底处理好。
这篇文章只讲本地目录模式。我们以 安卓修改大师安卓版 为例,从点“选择目录”那一步开始,一直讲到生成 APK、保存源码 ZIP、后续维护。你不需要先成为 Android 开发者,但需要理解一件事:本地站点不是“把网页塞进一个壳”,而是把一套静态文件原样装进应用,再让浏览器内核从一个固定的入口文件开始,按你写的路径去磁盘里找资源。任何一条路径写错,用户看到的就是白屏、无样式、破图,或者视频转圈。
只需说话,就能让应用变成你想要的样子——这句话在网址打包里尤其成立,但前提是你先把站点的目录和路径整理成“本地也能跑”的样子。下面从两个目录说起。
本地目录模式做了什么:website 与 app 两个目录
点开“网址打包”,选择“本地网页目录”,再选一个文件夹。选目录时,程序会先把这个文件夹整棵树复制到应用自己的缓存目录,检查根目录有没有 index.html;等你填完其余参数点“开始打包”,才创建项目。项目工作目录里会出现两个关键位置:一个是 website,存放你选中的整站文件;另一个是 app,是 AI 生成并负责编译的 Android 工程目录。前者是输入,后者是产出,很多后续问题都源于把这两个目录搞混。
website 是原样快照。程序把选中的目录复制到项目里,之后 AI 拿到的入口路径就是 <项目>/website/index.html。你在手机文件管理器里修改原来的文件夹,不会影响已经创建的项目;反过来,项目里的 website 被改动,也不会回写到你原来的目录。想要更新内容,正确做法是在项目里重新选一次目录,或者在项目文件里替换,然后重新生成,而不是改完原目录就以为 APK 会自动变。
app 是源码目录。发给 AI 的需求里明确要求“源代码目录”是项目工作目录下的 app 子目录,应用源代码工程必须放在这里;同时要求本地网站文件“整体打入应用”。所以一个完整的网址打包项目,最终至少有四层东西:原始站点快照 website、Android 工程 app、打包成品 应用名_版本.apk、以及记录配置的 config.ini 和历史 history.ini。成品最初以固定名字 webapp_ok.apk 出现,主程序检测到文件大小稳定后,会把它改名成“应用名_版本.apk”。这个“等大小稳定”的判断很实际:AI 刚写出文件时可能还在追加内容,过早改名会拿到一个半截包;连续两次看到同样大小,才认为写完了。
| 阶段 | 位置 | 作用 | 谁负责 |
|---|
| 选目录 | 应用缓存 | 把系统目录树复制成可读文件 | 程序 |
| 建项目 | <项目>/website | 本地站点快照,打包输入 | 程序 |
| 生成 | <项目>/app | Android 工程与页面资源 | AI |
| 成品 | <项目>/应用名_版本.apk | 可安装包 | AI 编译,程序改名 |
| 记录 | <项目>/config.ini | 内核、UA、方向、签名等参数 | 程序 |
这张表值得记住。后面讲“为什么改了页面没生效”“为什么源码 ZIP 里没有某个文件”,答案通常就在“你看的是哪一个目录”里。
根目录的 index.html:入口规则与四个误解
本地目录模式的第一个硬规则是:你选中的目录,根目录下必须有一个名为 index.html 的文件。 这不是建议,是校验条件。目录不存在会提示“本地网页目录不存在,请重新选择”;目录存在但没有根级 index.html,会提示“本地网页目录根目录下必须有 index.html,作为打包入口”。校验发生在你点“开始打包”之前,也发生在选目录之后的复制流程里,选错目录不会稀里糊涂进入下一步。
这条规则带来四个高频误解。第一个是把 index.htm 当成 index.html。两者在浏览器地址栏里可能都能打开,但打包器只认完整的 index.html,少一个字母就是“没有入口”。第二个是大小写,Index.html、INDEX.HTML 在 Windows 上看起来一样,在 Android 的文件系统里却是不同的名字;校验按精确文件名判断,不会替你猜。第三个是把站点放在子目录里,比如选中了整个项目文件夹,而首页在 www/index.html;这时根目录没有入口,正确做法是直接选中 www 这个文件夹。第四个是选中了上一级目录,里面装着好几个站点;打包器只认根目录那一个 index.html,其余子站不会被当成入口。
为什么一定要根目录?因为入口文件所在的目录,就是所有相对路径的基准。index.html 在根上,css/site.css 才会解析到 <根>/css/site.css;如果入口藏在 www/ 里,页面里的 css/site.css 就变成 <根>/www/css/site.css,而打包器只把 www 当根,两套基准一错位,资源就会大面积 404。把入口固定在根目录,是为了让“站点根”和“文件系统里的站点目录”重合,减少歧义。线上服务器也有类似的“默认文档”约定:访问一个目录时自动找 index.html 或 index.htm;本地模式没有服务器,只能由一个明确的入口文件开始,所以它把这条约定收紧成了硬条件。
一句话:入口在根上,相对路径才有唯一的起算点;入口藏一层,所有引用都要跟着重算。
还有三种页面不适合直接走本地模式。第一种是依赖服务端渲染的页面,比如 PHP、ASP、JSP 或者需要 Node 服务端拼 HTML 的站点;本地模式只能装静态文件,服务端代码不会执行。第二种是使用 history 路由的单页应用,路由地址 /detail/123 在服务器上可以回退到 index.html,在本地文件环境里没有这个回退,刷新或直接打开深链就会失败;要么改成 hash 路由,要么接受“只能从首页进入”。第三种是入口页只做跳转,比如 index.html 里立刻跳到另一个线上地址;这种包能装能开,但断网就废,本质上还是线上模式。
入口不是“随便一个首页”,而是根目录下名为 index.html 的那个文件选目录那一步:先复制,再校验
在手机上选目录,走的是系统的目录选择器,返回的是一个树形访问地址,而不是普通文件路径。AI 工作的目录只认应用自己可读的文件,读不到这种系统地址,所以程序会先把整棵树复制到缓存目录,再检查根目录有没有 index.html。复制过程有进度提示“正在读取本地网站目录…”,目录大、文件多时会等一会儿;这不是卡死,而是在把每个文件读出来再写一份。
复制有两个现实影响。第一,占空间。原目录一份、缓存一份、项目里的 website 又一份,在生成之前,同一个站点可能同时存在三份。手机剩余空间紧张时,选一个带大量视频的目录会明显变慢,甚至复制失败。第二,权限。系统目录选择器给的是读权限,程序只能读不能改;复制完成后,后续的打包都在应用自己的目录里进行,不再依赖原目录。原目录被删除、SD 卡拔出、云盘离线,都不会影响已经建好的项目。
复制完成后才是校验。校验只看两件事:目录是不是真的存在,根目录有没有 index.html。它不会检查你的 CSS 是否能加载,也不会检查图片路径是否写错;这些属于“内容问题”,要等成品出来以后自己验。所以选目录这一步的正确姿势是:先在电脑浏览器里把站点打开,确认首页、二级页、图片、字体、视频都正常,再把整个站点文件夹拷到手机上,选它的根目录。不要在手机上凭感觉选一个“看起来像”的文件夹。
创建项目时,程序会把缓存里的站点复制到 <项目>/website;如果是编辑已有项目并重新选目录,会先删除旧的 website 再复制新的,避免新旧文件混在一起。这个“先删后拷”的细节很重要:它意味着重新选目录是一次整体替换,不是增量合并。你删掉的原文件不会留在项目里,你新增的文件会整棵进来。想让新旧内容共存,只能在源目录里先合并好,再重新选。
选目录前的快速检查
一,根目录是否有 index.html;二,所有资源是否都在这个目录里面;三,文件名是否只有英文、数字、下划线和短横线。三条都过,再点选择目录,能省掉大半返工。
- 根目录的
index.html 是唯一入口,不要指望打包器替你找首页。 - 所有资源都在选中目录内部,不要引用目录外的共享文件。
- 文件名尽量用 ASCII,引用和被引用文件的名字完全一致。
一个能打包的本地站点长什么样
一个适合本地打包的站点,目录结构通常很朴素:入口在根上,资源按类型分文件夹,所有引用都在根目录内部。下面是一个可以直接照抄的骨架:
my-site/
├─ index.html
├─ css/
│ └─ site.css
├─ js/
│ └─ app.js
├─ img/
│ ├─ logo.png
│ └─ hero.jpg
├─ fonts/
│ └─ text.woff2
└─ media/
└─ introaddbutton20240616.mp4
这个骨架的关键不是“长这样才专业”,而是“自包含”。index.html 里写 css/site.css、js/app.js、img/logo.png;site.css 里写 url('../img/hero.jpg');app.js 里写 fetch('data/list.json') 或者干脆把数据内联成 JS 变量。所有路径都以站点根或当前文件为基准,不出现盘符、不出现 localhost、不出现上级目录之外的共享资源。
从 CMS、设计工具、文档工具导出的静态站点,经常带着“服务器思维”的痕迹:/assets/... 这种根相对路径、http://localhost:3000/... 这种本地开发地址、https://cdn.example.com/... 这种外链、../common/... 这种跨目录引用。导出后要做的第一件事不是打包,而是把这些引用改成本地相对路径,或者把依赖下载到站点目录里。尤其是根相对路径,它在服务器上完全正确,在本地却会把浏览器带到文件系统根或资产域根,表现就是“首页有字没样式、图片全裂”。
文件名也值得整理。Android 的文件系统区分大小写,Windows 不区分;在电脑上 Logo.PNG 和 logo.png 能互相顶替,装到手机上就是两张不同的文件。稳妥的做法是统一小写、只用英文、数字、下划线和短横线,避免空格、井号、问号、百分号。中文文件名在现代 Android 上通常能读,但一旦经过压缩、分享、不同内核,编码差异就会冒出来;能改成英文就改,不能改就至少保证引用和被引用文件的名字完全一致。
最后是体积。图片能压就压,视频能换清晰度就换,字体只留真正用到的字重。本地站点的所有资源都会进 APK,用户下载的是整个包;一个体积很大的课件包,分发、安装、升级都更费劲。把体积控制在“用户愿意下载”的范围内,比事后解释“为什么包这么大”有用得多。
还有两类文件建议在打包前删掉:一类是操作系统留下的隐藏文件,比如 Thumbs.db、.DS_Store,它们不会影响页面,但会跟着目录一起进包,增加体积也干扰排查;另一类是源文件,比如设计稿、PSD、未压缩的原始视频、备份压缩包。站点目录不是资料库,只放运行时要用的东西。选中目录后,程序会把整棵树复制过去,不会替你按扩展名筛选,所以“目录里有什么”就会“包里有什么”,清理要在选目录之前做。
相对路径与绝对路径:六种写法哪种在本地能用
路径写法可以归成六类,本地模式下的表现差别很大。下面这张表建议在改站点时贴在旁边:
| 写法 | 例子 | 线上服务器 | 本地 file:// | 说明 |
|---|
| 相对当前文档 | css/site.css | 可用 | 可用 | 最推荐,基准是入口文件所在目录 |
| 显式当前目录 | ./js/app.js | 可用 | 可用 | 与上一种等价,适合强调“就在当前层” |
| 相对上一级 | ../img/x.png | 可用 | 可能失败 | 不要越过站点根,越界文件不会被打包 |
| 根相对 | /css/site.css | 可用 | 失败 | 本地会解析到文件系统根或资产域根 |
| 绝对网络地址 | https://cdn.../x.js | 可用 | 联网可用、离线失效 | 离线包的大敌 |
| 本机绝对路径 | file:///C:/site/x.png | 失败 | 失败 | 绝对不能出现 |
根相对路径是本地目录模式的头号杀手,值得单独说清楚。假设入口被加载为 file:///android_asset/www/index.html,页面里写 /css/site.css,浏览器会把 / 解释为“文件系统根”,最终去找 file:///css/site.css,而不是 file:///android_asset/www/css/site.css。如果工程用的是资产域映射,比如把 assets/www 映射到 https://appassets.androidplatform.net/assets/www/,页面里的 /css/site.css 又会解析到 https://appassets.androidplatform.net/css/site.css,跑到了映射前缀之外,同样找不到。两种加载方式不同,错误结果却一样:样式全丢。
修正的方法很机械:把所有以 / 开头的 src、href、url() 改成相对路径。/css/site.css 改成 css/site.css 或 ./css/site.css;/img/logo.png 改成 img/logo.png;CSS 里的 url(/fonts/x.woff2) 改成 url('../fonts/x.woff2'),因为 CSS 里的相对路径是相对 CSS 文件本身,不是相对 HTML。改完在电脑上用一个本地静态服务器预览一遍,再打包,别只在文件管理器里双击 HTML 看。
文件多的时候不要靠肉眼翻。可以在电脑上对整个站点做一次文本搜索,先把嫌疑最大的写法列出来:src="/、href="/、url(/、url("/、http://localhost、file:///、反斜杠路径。Windows 上可以用资源管理器的内容搜索,也可以用命令行工具递归查;查到一处改一处,改完再搜一遍,直到这些模式归零。这个动作看起来笨,但它能在打包前消灭大部分“首页有字没样式”的问题,比装到手机上再猜快得多。
另外几个细节也常常导致“明明文件在,就是加载不到”。反斜杠 css\site.css 在 Windows 浏览器里可能被容忍,在 Android 上不是合法分隔符,统一用正斜杠。<base href="/"> 会把所有相对路径的基准改到根,本地模式不要用;如果非要用,改成 <base href="./">。文件名里的空格要写成 %20,但更省事的做法是根本不用空格。带查询串的 app.js?v=3 通常不影响本地读取,但要确认加载器不会把查询串当成文件名的一部分。带井号的 guide.html#top 是片段标识,不会去读一个叫 guide.html#top 的文件,这个一般没问题,但如果文件名本身含 #,就会被当成片段,直接读不到。
根相对路径在服务器上是“网站根”,到了本地常常变成“文件系统根”CSS、JS、图片、字体、视频:逐类资源的引用规则
CSS 是本地站点里最容易出问题的一层,因为它有自己的相对基准。site.css 里的 url('../img/bg.jpg'),基准是 site.css 所在的 css 目录,不是 index.html 所在的项目根;所以 ../ 是对的。@import 'reset.css' 也是相对当前 CSS 文件。@font-face 的 src: url('../fonts/text.woff2') 同理。把 CSS 内联进 HTML 反而会改变基准,原本相对 CSS 文件的路径会变成相对 HTML,迁移时要一起改。
JS 的问题分三类。第一类是脚本自身的 src,和图片一样按 HTML 的相对路径找。第二类是脚本里动态拼接的地址,比如 fetch('data/list.json')、new Worker('worker.js')、import('./module.js');这些地址的基准是“当前文档地址”,在 file:// 下常常被安全策略拦住。第三类是第三方脚本,统计、地图、客服、字体库,默认都从 CDN 加载,离线时不是报错就是拖慢首屏。本地包的原则是:能内联的数据就内联,能本地化的库就下载到 js/,确实需要联网的功能要做失败兜底,别让一个统计脚本把整个页面卡住。
图片的坑主要在 srcset、picture 和 SVG。img src="img/a.png" 最稳;srcset="img/a@2x.png 2x" 要求每一张都存在,缺一张不会整体失败,但会悄悄回退;picture 里的 source srcset 同理。SVG 里用 xlink:href="#icon" 引用同一文件内的符号通常没问题,引用外部 SVG 文件时路径要相对当前文档。favicon 经常被忽略,<link rel="icon" href="/favicon.ico"> 的根路径在本地会 404,虽然不影响主页面,但会在控制台留下噪音。
字体的关键不是路径,而是格式和授权。woff2 在现代内核上支持最好,ttf 兼容性更广但体积大;本地字体没有跨域问题,但如果字体文件缺失,页面会静默回退到系统字体,看起来“只是字变了”,很难第一眼发现。验收时专门看一眼标题字体和图标字体,确认没有变成方块或默认宋体。
视频和音频要单独验。src 指向本地 MP4 时,路径正确只是第一步;还要看编码、容器、音轨、字幕、封面、自动播放策略、全屏、拖动进度、切后台再回来。不同内核对本地视频的支持差别很大,尤其大文件、H.265、字幕轨。自动播放通常被限制,静音自动播放也可能被某些内核拦截;产品页里如果写了“打开自动播放”,验收时一定要在真机上确认,不能只看电脑浏览器。
数据文件是另一个高频断点。很多静态站点把列表、配置、翻译放在 data/*.json,页面用 fetch 或 XMLHttpRequest 读取。file:// 下这类请求经常被当作跨域拦截,控制台报 CORS 或“Not allowed to load local resource”。解决办法有三个:把 JSON 直接写成 JS 变量随页面加载;改用资产域映射,让页面跑在 https:// 资产域下;或者把数据在构建时内联进 HTML。选哪个取决于数据量和更新频率,但不能假设“本地文件一定能 fetch”。
file:// 与 WebView:本地页面到底怎么被加载
APK 里的网页资源通常放在 assets 目录,WebView 通过 file:///android_asset/... 访问。这个地址看起来像普通文件路径,实际上是由 WebView 内部映射到 APK 的 assets,不经过 Linux 文件系统。页面加载后,它的 origin 是 file://,这是一个不透明源:fetch 本地文件、ES module 的跨文件导入、Service Worker、Cookie 这些依赖“正常 HTTP 源”的能力,经常会受限或行为不一致。
为了绕开 file:// 的限制,Android 工程里常见另一种做法:用资产加载器把 assets 下的目录映射成一个虚拟的 https:// 域名,再让 WebView 加载这个域名下的入口。这样页面有了正常的 HTTPS 源,fetch、模块、存储、Cookie 的行为更接近线上,根相对路径也有了明确的“域根”。代价是工程里要多一层请求拦截,路径前缀必须映射对,MIME 类型要返回正确,否则会出现“文件存在但浏览器不认”的怪问题。
两种方式都能用,区别在于页面依赖什么。纯图文、纯静态、脚本都是传统脚本的站点,file:///android_asset/ 足够;依赖 fetch 读 JSON、ES module、Service Worker、或者需要稳定 Cookie 的站点,资产域映射更稳。验收时不要问“用的是哪一种”,而要问“页面需要的每一项能力,在当前加载方式下是否真的可用”。白屏、样式丢失、接口 404,最终都要落到这两层:入口地址对不对,资源请求有没有被拦。
WebView 还有几项设置会影响本地页面。文件访问开关没开,file:// 页面可能读不到其他本地文件;跨文件访问开关没开,脚本发起的本地请求会被拒;混合内容策略会把 HTTPS 页面里的 HTTP 资源拦掉;Android 9 以后默认禁止明文 HTTP,页面里如果还写着 http:// 的图片或接口,就会静默失败。权限也别忘了:页面引用线上资源时,应用需要网络权限;没有权限时,外链图片不会报“权限不足”,只会显示空白。
导航行为也要在验收清单里。用户点页面里的链接,是继续在应用内打开,还是跳去系统浏览器?跳到浏览器以后,按返回键能不能回到应用?外部链接、mailto:、tel:、微信/支付宝 scheme,分别应该怎么处理?这些不是内核能自动决定的,而是外壳的导航策略。一个本地门户包,如果点“附件下载”直接跳出应用且回不来,用户会认为应用坏了。
缓存也值得单独提一句。WebView 会缓存页面、图片、脚本,替换 assets 里的文件后重新安装,如果版本号没变、包名没变,偶尔会看到旧内容。验收“更新是否生效”时,最稳妥的做法是卸载旧版再装新版,或者把版本号加一后再覆盖安装;不要只在应用里点点刷新,就断定新资源已经生效。这个现象不是打包器的问题,而是浏览器缓存的正常行为,知道它存在,就不会把“改了没变”误判成打包失败。
同一条相对路径,在 file:// 与 https 资产域下可能解析成完全不同的地址四种内核加载本地页的差异
安卓修改大师安卓版给网址打包提供四个内核:Android WebView(Chromium)、腾讯 X5(TBS)、GeckoView(Firefox)、Crosswalk(Chromium,兼容老旧设备)。它们都能加载本地页面,但“本地”的实现方式、文件访问限制、媒体能力和排查路径不一样。本地目录模式选内核,重点不是谁更新,而是谁能让你的这套静态资源稳定跑起来。
| 内核 | 本地入口常见形态 | 资源访问 | 视频与媒体 | 主要风险 |
|---|
| Android WebView | file:///android_asset/... 或资产域 | 跟系统 WebView 版本走 | 常见 MP4 稳,HLS/DRM 要测 | 老机型内核旧、厂商定制差异 |
| 腾讯 X5 | 由 TBS 加载本地页 | 受 TBS 版本与文件访问设置影响 | 国内播放器与 HLS 通常更省心 | 体积大、行为随 TBS 版本变化 |
| GeckoView | resource://android/assets/... 或本地文件 | 独立引擎,路径规则不同 | 自有媒体栈,编码支持要实测 | 资料少、生态与 Chromium 不同 |
| Crosswalk | file:///android_asset/... | 固定旧 Chromium | 旧媒体栈,新编码支持有限 | 已停止更新,安全风险最高 |
WebView 是最“通用”的一档。它不把内核打进 APK,页面由设备系统 WebView 渲染,所以包体最轻,和系统存储、文件选择、下载的衔接也最自然。代价是你控制不了用户设备上的内核版本:同一份 CSS,在新机型上正常,在老机型上可能缺少某个特性;同一段 JS,在新内核上能跑,在旧内核上可能语法都不认。本地站点如果用了较新的前端构建产物,先在目标机型上试,别假设“Android 10 以上都一样”。
X5 的优势在视频和国内页面适配。它把腾讯的浏览服务带进应用,对国内常见的播放器、HLS、旧页面写法通常更宽容。本地目录模式下,X5 也要面对文件访问和路径映射的问题,而且不同 TBS 版本的行为可能有差异;同样一个 file:///android_asset/ 入口,在某个版本上能读,在另一个版本上可能被安全策略收紧。用它之前,拿目标页面和目标设备走一遍首页、视频、全屏、切后台,比看版本号可靠。
GeckoView 是独立引擎,最大的价值是“不受系统 WebView 版本影响”。它的本地资源入口和 Chromium 系不一样,打包工程里常见的 file:///android_asset/ 在 Gecko 下未必是同一个地址,通常要用它自己的资源协议来读 assets。页面如果依赖 Chromium 特有的行为、微信生态的桥接、或者国内播放器,换到 Gecko 就要重新验一遍。它的资料也相对少,遇到问题能查的案例不如 Chromium 多。
Crosswalk 是把一套旧 Chromium 直接嵌进应用,渲染固定、可控,适合“页面是按老内核写死的,换新内核就错位”的受控场景。它的代价是包体最大、内核停止更新、现代前端可能不兼容,而且用不再更新的内核加载公网内容有安全风险。本地目录模式如果只是离线课件、固定设备、不访问外网,Crosswalk 还能当过渡方案;新项目不该把它当起点。
切换内核不是换皮肤。入口地址、文件访问、脚本模块、字体、视频、Cookie、本地存储都可能变,换完必须按新包重新验收。UA 也不会改变本地资源的解析方式,它只影响服务端下发的页面版本和页面里的浏览器判断;本地站点没有服务端,UA 的作用更小,别指望改 UA 能修好路径问题。
两个自家实例:内网制度门户与离线培训课件
第一个例子是自家公司的内网制度门户。行政和 IT 把制度文件导成了一套静态站点,根目录有 index.html,下面有“人事”“财务”“安全生产”三个栏目,页面是纯 HTML 加 CSS,搜索用一段本地 JS 读 data/index.json,附件是 PDF。以前的做法是发一个压缩包到群里,让大家解压后用手机浏览器打开;Android 上经常打不开,或者打开了点不动,最后演变成“要看制度去电脑上查”。IT 也试过自己写一个 WebView 壳,但每次制度更新都要重新编译、重新签名、重新发版。
现在的做法是:在安卓修改大师安卓版里选“网址打包”,打包目标选安卓,网站来源选“本地网页目录”,选中门户站点的根目录,确认根目录有 index.html。内核选 Android WebView,页面风格普通,屏幕方向竖屏,返回键设为“先返回历史网页,再退出”,打开退出确认;用户协议按内部应用的习惯关闭。图标换成公司内网应用的图标,版本号从 1 开始,签名用团队自己的 JKS,方便后续覆盖升级。点开始打包后,等成品出现,先保存 APK,再保存一份源码。
以前每次更新都要重新找人打包,现在一次配置之后,更新制度内容只需要重选目录、重新生成。这个例子的验收动作很具体:开飞行模式,冷启动应用,确认首页三个栏目都能进;点开每一篇制度,确认正文、表格、附件链接都在;在搜索框输入一个关键词,确认本地 JSON 能读出来;按返回键逐级后退,首页再按一次出现退出确认;旋转屏幕,确认布局不错位;最后看设置里的应用信息,确认版本号和图标正确。第一次验收时,搜索功能是空的,原因是 fetch('data/index.json') 在 file:// 下被拦了;把数据改成随页面加载的 JS 变量后恢复正常。这个坑很典型,不是路径写错,而是加载方式不支持。
离线验收要开飞行模式,从首页一路点到最深的页面,再按返回键走回来第二个例子是培训团队的离线课件。课程是一套静态页面,根目录 index.html,每一章一个 HTML,图片、音频、MP4 视频、练习题都在目录里,学习进度存在浏览器的 localStorage。以前他们用电脑上的打包工具,把目录压成包再套壳,换一台电脑、换一个同事,流程就要重新教一遍;更麻烦的是,课件里有几段视频用了根相对路径,电脑上预览正常,装到平板上就黑屏。每次开课前都要有人专门试一遍,试出问题再临时改。
现在的做法是:手机或平板上选本地目录,根目录确认 index.html,内核仍然选 WebView,因为学员设备是 Android 10 以上的平板,视频是本地 MP4,系统解码器足够;屏幕方向按课程设计选横屏,启动屏打开,倒计时 3 秒,返回键设为历史后退,退出确认打开,统计不接——离线课件没有联网统计的意义。生成后先别发给学员,自己装一台目标平板,开飞行模式,从第一章走到最后一章。
验收清单比内网门户多几项:每一段视频都要点开,看首帧、播放十秒、拖动进度、全屏、横屏旋转、切后台再回来;音频要听是否有声音、能否暂停续播;练习题提交后,退出应用再进,看 localStorage 里的进度是否还在;点页面里的外链,确认不会跳到浏览器后回不来;最后看安装包大小,确认没有把不必要的源文件打进去。这个团队后来把“开飞行模式走一遍”写进了开课前的固定流程,比任何口头交接都管用。他们还会把同一个包分别装到一台手机和一台平板上,因为屏幕比例、厂商内核、横竖屏策略都可能不同;手机上正常不代表平板上正常,尤其是固定横屏的课件。
两个例子的共同点是:页面本身不复杂,复杂的是“本地”这两个字带来的路径和加载约束。把入口、相对路径、资源类型、内核、验收顺序五件事定下来,本地目录模式就会从“碰运气”变成“可重复”。
生成之后:一张验收清单
成品出来以后,不要只看“能打开”。本地站点的很多问题藏在二级页、资源加载和边缘动作里。下面这张清单按顺序走一遍,能覆盖大多数返工点:
- 开飞行模式,冷启动应用,确认首页不是白屏、不是错误页。
- 从首页进入每一个一级栏目,再进二级页,确认没有 404、没有空白页。
- 看样式:标题字体、颜色、间距、按钮圆角是否和电脑上一致;如果全丢,优先查根相对路径。
- 看图片:首屏图、列表缩略图、背景图、图标、favicon 是否都在;破图优先查大小写和目录层级。
- 看字体:图标字体是否变成方块,正文是否回退到系统字体;缺字体通常不影响功能,但影响观感。
- 看脚本:搜索、筛选、标签页切换、表单校验是否工作;打开控制台或看页面提示,确认没有脚本报错。
- 看数据:
fetch 的 JSON、配置、翻译是否加载;本地请求被拦时,改成内联数据或资产域。 - 看视频和音频:播放、暂停、拖动、全屏、旋转、切后台、锁屏再回来。
- 看存储:localStorage、登录态、学习进度在杀进程后是否还在;不同内核表现不同,必须实测。
- 看导航:返回键是否逐级后退,首页再按是否退出或确认;外链是否跳出应用,能否回来。
- 看权限与网络:需要联网的页面在无网时是否有兜底;有网时外链图片、字体、接口是否正常。
- 看包体与签名:安装包大小是否可接受,版本号是否递增,签名是否能覆盖旧版本。
如果首页白屏,不要急着重打,先做二分:把 index.html 换成一个只有一行文字的极简页面,重新打包。极简页能开,说明外壳和入口没问题,问题在页面资源;极简页也不能开,说明入口、加载方式或内核有问题。然后再逐段加回 CSS、JS、图片,哪一段加回去就坏,问题就锁定在哪一段。这个方法比盯着整站猜快得多。
如果页面能开但样式全丢,优先查三件事:根相对路径、CSS 文件是否真的进了包、CSS 里的 url() 是否相对错了目录。如果图片全裂但 CSS 正常,优先查大小写、文件名里的空格和中文、以及图片是否在选中的目录之外。如果视频黑屏但音频正常,优先查编码和容器,再查本地加载方式是否支持按范围读取。如果只有搜索不工作,优先查 fetch 和 JSON 路径。
签名也要在验收里。内部测试可以用默认签名,但要做覆盖升级,就用团队自己的 JKS,并把别名和口令记好;随机签名每次不同,连覆盖安装都做不到,只适合一次性的演示包。版本号要递增,否则系统会拒绝降级覆盖。验收时拿旧版本装一次、再装新版本,确认能覆盖、数据还在,比只看“安装成功”更有意义。
保存源码 ZIP:本地站点项目的底稿
打包完成窗口里有“保存源代码”,成品详情页里也有同样的入口。它做的事情很朴素:把项目工作目录下的 app 目录整棵压成一个 ZIP,名字是“应用名_source.zip”,让你选一个目录保存。如果 app 目录不存在,完成窗口会显示“没有找到 app 源代码目录”,按钮不可用;详情页会提示同样的路径。这个 ZIP 不是 APK 的备份,而是 Android 工程的快照,里面应该包含 build.gradle、src/main/AndroidManifest.xml、Java 或 Kotlin 源码、res 资源,以及被打进 assets 的网页文件。
对本地站点项目来说,这个 ZIP 的价值在“可追溯”。哪天页面要改版、图标要换、启动图要更新,或者要交给另一个同事接手,有源码比只有一个 APK 从容得多;至少你能看到上一版到底把哪些文件打进了应用,assets 里的 index.html 和 CSS 是什么样子。原站点目录也要保留,它是内容源;ZIP 是工程快照,两者不是一回事。源码 ZIP 的详细验收方法、什么时候不该存,另有专文讨论,这里只先建立一个概念:成品、源码、原站点,三份东西各管一段。
生成完成之后,项目并不会“锁死”。在项目列表里点编辑,如果已经生成了 APK,程序会把成品接成一个普通 APK 项目,之后可以继续用一句话让 AI 改;如果还没生成,就回到网址打包表单继续调参数。这个设计意味着你可以先出一个能用的版本,再慢慢改图标、名称、启动图,而不必从网址重新来一遍。改完重新打包时,记得版本号加一,签名保持一致,否则覆盖安装会失败。
常见问题:本地目录模式的十二个问答
问:根目录没有 index.html,但有一个 index.htm,能打包吗?答:不能。校验只认 index.html,把文件改名,或者确认导出工具是否支持指定首页文件名。
问:首页在 www 子目录里,选整个项目文件夹行不行?答:不行。直接选 www 这个文件夹,让 index.html 落在你选中目录的根上。
问:页面在电脑上双击能开,打包后为什么白屏?答:电脑浏览器对 file:// 更宽容,Android WebView 的限制更多。优先查根相对路径、fetch、ES module、大小写。
问:CSS 和 JS 都在,为什么样式就是不对?答:看 CSS 里的 url() 是不是相对错了目录,看字体和图片是否 404,看是否有多个同名 CSS 覆盖。
问:中文文件名能用吗?答:多数现代设备能读,但编码、压缩、分享链路都可能出问题。能改成英文就改,不能改就保证引用完全一致。
问:本地页面能联网吗?答:能,但要看页面怎么写、应用有没有网络权限、是否被明文 HTTP 策略拦截。离线包不要依赖外网资源。
问:视频很大,能直接放进本地目录吗?答:能,但 APK 会很大,安装、升级、分享都更费劲。先压缩,或者把视频放到线上按需加载。
问:更新了原站点目录,APK 会自动更新吗?答:不会。项目里是快照,要重新选目录、重新生成。
问:换内核能修好路径问题吗?答:通常不能。路径是页面自己的事,换内核只会改变加载方式和限制,先把路径改对。
问:本地目录能放子目录吗?答:能,层级不限,打包会把整棵树复制进去;但入口必须在根上,页面里的相对路径要和实际层级对得上,别让子目录里的页面用错 ../ 的层数。
问:为什么每次更新内容都要重新选目录?答:项目里保存的是选中那一刻的快照,不是对原目录的实时引用。重新选目录会整体替换项目里的 website,这是为了避免新旧文件混在一起;如果想保留旧版,先备份项目或源码 ZIP。
问:源码 ZIP 里为什么没有 website 目录?答:ZIP 压的是 app 工程目录,网页文件应该在 app 的 assets 里;website 是项目里的输入快照,不在 app 下。要留内容源,另外备份原站点目录。
先把入口、路径、加载方式三件事分开查,白屏问题会简单很多写在最后
本地目录模式不是“把网页拖进手机”那么简单,它把 Web 开发里被服务器遮住的那一层摊开了:入口文件在哪,相对路径以谁为基准,资源有没有真的进包,浏览器内核允许页面做什么。把这四件事想清楚,剩下的就是重复验收。安卓修改大师安卓版把选目录、复制、校验、生成、打包、保存源码串成了一条手机上的流水线,但页面本身的目录和路径,仍然需要你在打包前整理干净。
安卓修改大师智改工坊 的产品介绍在这里:https://www.apkeditor.cn/ai-version.aspx。官网是 www.apkeditor.cn。安卓修改大师安卓版支持线上网址和本地目录两种打包方式,四个内核可选,成品可以安装、分享,也可以继续用一句话修改;源码 ZIP 则为后续维护留了一份底稿。
只需说话,就能让应用变成你想要的样子。下一次做本地站点打包,别急着点生成:先确认根目录的 index.html,再把所有根相对路径改成相对路径,最后开飞行模式走一遍。三件事做完,本地目录模式就会变成一件很稳的事。
合规提醒:本文的方法只适用于自有版权、内部使用或已获得明确授权的网页与应用。把别人的网站打包成自己的应用、去掉页面的授权提示、绕过付费或安全机制,都不在讨论范围内。
“内网门户以前发压缩包,安卓上根本打不开。现在做成 APK,飞行模式也能查制度,最关键是搜索的 JSON 改成了内联数据。”
—— 陈工 · 企业信息化
“离线课件最怕视频黑屏。现在打包前先把根相对路径全改掉,再开飞行模式从头到尾点一遍,开课当天心里有底。”
—— 小林 · 课程制作
“我们站点从服务器导出时全是 /assets 开头的路径,电脑上预览正常,手机上样式全丢。改成相对路径后一次就过。”
—— 阿哲 · 前端开发
“第一次选目录选到了上一层,根目录没有 index.html,校验直接拦住了。这个提示比事后白屏友好太多。”
—— 吴老师 · 职业培训
“门店物料页要离线展示,图片多、还有视频。现在固定用同一套目录结构,换内容只换文件夹,验收清单照着走。”
—— 老李 · 门店运营
DOWNLOAD
安卓修改大师智能修改安卓版
手机、平板直接安装,导入 APK 后说一句话,自动反编译、修改、回编、对齐、签名;也能把网址打包成应用,成品可装、可存、可分享。
立即下载安卓版 / 查看详情 →官网 www.apkeditor.cn · 请仅修改自有版权或已获授权的应用