在上一篇文章《微信小程序「反編譯」實戰(一):解包》中,我們詳細介紹了如何獲取某一個小程序的 .wxapkg 包,以及分析了 .wxapkg 包的結構,最後通過腳本解壓獲取包中的文件:小程序「編譯」後的代碼文件和資源文件,但是由於這些文件大部分被混淆了,可讀性很差,所以本文將進一步分析,儘可能地把 .wxapkg 包的內容還原為「編譯」前的內容。
註:本文包含一部分源碼分析,由於手機屏幕較小,閱讀體驗可能不佳,建議在電腦上瀏覽。
特別感謝:下文使用的還原工具來自於 GitHub 上的開源項目 wxappUnpacker,在此特別感謝原作者的無私貢獻。
概覽我們知道,前端 Web 網頁編程採用的是 HTML + CSS + JS 這樣的組合,其中 HTML 是用來描頁面的結構,CSS 用來描述頁面的樣子,JS 通常用來處理頁面邏輯和用戶的交互。類似地,在小程序中也有同樣的角色,一個小程序工程主要包括如下幾類文件:
例如 知識小集 的小程序源碼工程結構如下:
然而,根據上一篇文章介紹,對 知識小集 小程序的 .wxapkg 解包後得到如下文件:
主要包括 app-config.json, app-service.js, page-frame.html, *.html, 資源文件 等,但這些文件已經被「編譯混淆」並重新整合壓縮,微信開發者工具並不能識別它們,我們無法直接對它們進行調試/編譯運行。
所以,我們先嘗試分析一下從 .wxapkg 提取出來的各個文件內容的結構及其用途,然後介紹如何用腳本工具把它們一鍵還原為「編譯」前的源碼,並在微信開發者工具中跑起來。
文件分析本節主要以 知識小集 小程序的 .wxapkg 解包後的源碼文件為例,進行分析。
你也可以跳過本節的分析,直接看下一節介紹用腳本「反編譯」還原源碼。
app-config.json小程序工程主要包括工具配置 project.config.json,全局配置 app.json 以及頁面配置 page.json 三類 JSON 配置文件。其中:
project.config.json 主要用於對開發者工具進行個性化配置以及包括小程序項目工程的一些基礎配置,所以它不會被「編譯」到 .wxapkg 包中;
app.json 是對當前小程序的全局配置,包括了小程序的所有頁面路徑、界面表現、網絡超時時間、底部 tab 等;
page.json 用於對每一個頁面的窗口表現進行配置,頁面中配置項會覆蓋 app.json 的 window 中相同的配置項。
因此「編譯」後的文件 app-config.json 其實就是 app.json 和各個頁面的配置文件的匯總,它的內容大致如下:
{
"page": { // 各頁面配置
"pages/index/index.html": { // 某一頁面地址
"window": { // 某一頁面具體配置
"navigationBarTitleText": "知識小集",
"enablePullDownRefresh": true
}
},
// 此處省略...
},
"entryPagePath": "pages/index/index.html", // 小程序入口地址
"pages": ["pages/index/index", "pages/detail/detail", "pages/search/search"], // 頁面列表
"global": { // 全局頁面配置
"window": {
"navigationBarTextStyle": "black",
"navigationBarTitleText": "知識小集",
"navigationBarBackgroundColor": "#F8F8F8",
"backgroundColor": "#F8F8F8"
}
}
}
通過與原工程 app.json 和各頁面配置 page.json 內容的對比,我們可以得出 app-config.json 匯總文件的簡單整合規律,很容易把它拆分成「編譯」前對應的各 json 文件。
app-service.js在小程序項目中 JS 文件負責交互邏輯,主要包括 app.js,每個頁面的 page.js,開發者自定義的 JS 文件和引入的第三方 JS 文件,在「編譯」後所有這些 JS 文件都會被匯總到 app-service.js 文件中,它的結構如下:
var __wxAppData = {};
var __wxRoute;
var __wxRouteBegin;
var __wxAppCode__ = {};
var global = {};
var __wxAppCurrentFile__;
var Component = Component || function(){};
var definePlugin = definePlugin || function(){};
var requirePlugin = requirePlugin || function(){};
var Behavior = Behavior || function(){};
global.__wcc_version__='v0.6vv_20180125_fbi';
global.__wcc_version_info__={"customComponents":true,"fixZeroRpx":true,"propValueDeepCopy":false};
define("utils/util.js", function(require, module, exports, window,document,frames,self,location,navigator,localStorage,history,Caches,screen,alert,confirm,prompt,XMLHttpRequest,WebSocket,Reporter,webkit,WeixinJSCore) {
"use strict";
});
define("app.js", function(...) {
"use strict";
});
require("app.js");
__wxRoute = 'pages/index/index';
__wxRouteBegin = true;
define("pages/index/index.js", function(...){
"use strict";
});
require("pages/index/index.js");
在這個文件中,原有小程序工程中的每個 JS 文件都被 define 方法定義聲明,定義中包含 JS 文件的路徑和內容,如下:
define("path/to/xxx.js", function(...){
"use strict";
});
因此,我們同樣很容易提取這些 JS 文件源碼,並恢復至相應的路徑位置中。當然,這些 JS 文件中的內容經過混淆壓縮,我們可以使用 UglifyJS 這樣的工具進行美化,但仍很難還原一些原始變量名,不過基本不影響正常閱讀和使用。
page-frame.html在小程序中使用 WXML 文件描述頁面的結構,WXSS 文件描述頁面的樣式。工程中有一個 app.wxss 文件用於定義一些全局的樣式,會自動被 import到各個頁面中;另外每個頁面也都分別包含 page.wxml 和 page.wxss 用於描述其頁面的結構和樣式;同時,我們也會自定義一些公共的 xxxCommon.wxss 樣式文件和公共的 xxxTemplate.wxml 模板文件供一些頁面復用,一般在各自頁面的 page.wxss 和 page.wxml 中去 import。
當「編譯」小程序後,所有的 .wxml 文件和 app.wxss 及公共 xxxCommon.wxss 樣式文件的將被整合到 page-frame.html 文件中,而每個頁面的 page.wxss 樣式文件,將分別單獨在各自的路徑下生成一個 page.html 文件。
page-frame.html 文件的內容結構如下:
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0" />
<meta http-equiv="Content-Security-Policy" content="script-src 'self' 'unsafe-inline'">
<link rel="icon" href="data:image/ico;base64,aWNv">
<script>
var __pageFrameStartTime__ = Date.now();
var __webviewId__;
var __wxAppCode__ = {};
var __WXML_GLOBAL__ = {
entrys: {},
defines: {},
modules: {},
ops: [],
wxs_nf_init: undefined,
total_ops: 0
};
window.__wcc_version__ = 'v0.6vv_20180125_fbi';
window.__wcc_version_info__ = {
"customComponents": true,
"fixZeroRpx": true,
"propValueDeepCopy": false
};
var $gwxc
var $gaic = {}
$gwx = function(path, global) {
}
var BASE_DEVICE_WIDTH = 750;
var isIOS = navigator.userAgent.match("iPhone");
var deviceWidth = window.screen.width || 375;
var deviceDPR = window.devicePixelRatio || 2;
function checkDeviceWidth() {
}
checkDeviceWidth()
var eps = 1e-4;
function transformRPX(number, newDeviceWidth) {
}
var setCssToHead = function(file, _xcInvalid) {
}
setCssToHead([])();
setCssToHead([...]);
var __pageFrameEndTime__ = Date.now()
</script>
</head>
<body>
<div></div>
</body>
</html>
相比其他文件,page-frame.html 比較複雜,微信把 .wxml 和部分 .wxss 直接「編譯」並混淆成 JS 代碼放入上述文件中,然後通過調用這些 JS 代碼來構造 Virtual-Dom,進而渲染頁面。
其中最核心的是 $gwx 和 setCssToHead 這兩個方法。
$gwx 用於通過 JS 代碼生成所有 .wxml 文件,其中每個 .wxml 文件的內容結構都在 $gwx 方法中被定義好並混淆了,我們只要傳給它頁面的 .wxml 路徑參數,即可獲取到每個 .wxml 的內容,再簡單加工一下即可還原成「編譯」前的內容。
在 $gwx 中有一個 x 數組用於存儲當前小程序都有哪些 .wxml 文件,例如,知識小集 小程序的 x 值如下:
var x = ['./pages/detail/detail.wxml', '/towxml/entry.wxml', './pages/index/index.wxml', './pages/search/search.wxml', './towxml/entry.wxml', '/towxml/renderTemplate.wxml', './towxml/renderTemplate.wxml'];
此時我們可以在 Chrome 中打開 page-frame.html 文件,然後在 Console 中輸入如下命令,即可得到 index.wxml 的內容(輸出一個 JS對象,通過遍歷這個對象即可還原出 .wxml 的內容)
$gwx("./pages/index/index.wxml")
setCssToHead 方法用於根據幾段被拆分的樣式字符串數組生成 .wxss 代碼並設置到 HTML 的 Head 中,同時,它還將所有被 import 引用的 .wxss 文件(公共 xxxCommon.wxss樣式文件)所對應的樣式數組內嵌在該方法中的 _C 變量中,並標記哪些文件引用了 _C 中數據。另外在 page-freme.html 文件的末尾,調用了該方法生成全局 app.wxss 的內容設置到 Head 中。
因此,我們可以在每個調用 setCssToHead 方法的地方提取相應 .wxss 的內容並還原。
對於 page-freme.html 文件中 $gwx 和 setCssToHead 這兩個方法更詳細的分析,可以參考這篇文章 https://bbs.pediy.com/thread-225289.htm 。
此外,checkDeviceWidth 方法顧明思議,用於檢測屏幕的寬度,其檢測結果將用於 transformRPX 方法中將 rpx 單位轉換為 px 像素。
rpx 的全稱是 responsive pixel,它是小程序自己定義的一個尺寸單位,可以根據當前設備屏幕寬度進行自適應。小程序中規定,所有的設備屏幕寬度都為 750rpx,根據設備屏幕實際寬度的不同,1rpx所代表的實際像素值也不一樣。
*.html上面提到,每個頁面的 page.wxss 樣式文件,「編譯」後將分別在各自的所在路徑下生成一個 page.html 文件,每個 page.html 的結構如下:
<style></style>
<page></page>
<script>
var __setCssStartTime__ = Date.now();
setCssToHead([...])()
var __setCssEndTime__ = Date.now();
document.dispatchEvent(new CustomEvent("generateFuncReady", {
detail: {
generateFunc: $gwx('./pages/search/search.wxml')
}
}))
</script>
在該文件中通過調用 setCssToHead 方法將 .wxss 樣式內容設置到 Head 中,所以同樣地,我們可以根據 setCssToHead 的調用參數提取每個頁面的 page.wxss。
資源文件小程序工程中的圖片、音頻等資源文件在「編譯」後將直接被拷貝到 .wxapkg包中,其原始的路徑也保留不變,因此我們可以直接使用。
「反編譯」在上一節,我們完成了 .wxapkg 包幾乎所有文件內容的簡要分析。現在我們介紹一下如何通過 node.js 腳本幫我們還原出小程序的源碼。
在這裡需要再次感謝 wxappUnpacker 作者提供的還原工具,讓我們可以「站在巨人的肩膀上」輕鬆地去完成「反編譯」。它的使用如下:
node wuConfig.js <path/to/app-config.json> : 將 app-config.json 中的內容拆分成各個頁面所對應的 page.json 和 app.json;
node wuJs.js <path/to/app-service.js> : 將 app-service.js 拆分成一系列原先獨立的 JS 文件,並使用 Uglify-ES美化工具儘可能將代碼還原為「編譯」前的內容;
node wuWxml.js [-m] <path/to/page-frame.html> : 從 page-frame.html 中提取並還原各頁面的 .wxml 和 app.wxss 及公共 .wxss 樣式文件;
node wuWxss.js <path/to/unpack_dir> : 該命令參數為 .wxapkg 解包後目錄,它將分析並從各個 page.html 中提取還原各頁面的 page.wxss 樣式文件;
同時,作者還提供了一鍵解包並還原的腳本,你只需要提供一個小程序的 .wxapkg 文件,然後執行如下命令:
node wuWxapkg.js [-d] <path/to/.wxapkg>
此腳本就會自動將 .wxapkg 文件解包,並將包中相關的已被「編譯/混淆」的文件自動地恢復原狀(包括目錄結構)。
PS: 此工具依賴 uglify-es, vm2, esprima, cssbeautify, css-tree 等 node.js 包,所以你可能需要 npm install xxx 安裝這些依賴包才能正確執行。
更詳細的用法及相關問題請查閱該開源項目的 GitHub repo。
最後,我們在 微信開發者工具 中新建一個空小程序工程,並將上述還原後的相關目錄文件導入工程,即可編譯運行起來,如下圖為 知識小集 小程序的 .wxapkg 包還原後的代碼工程:
以上,大功告成!
總結本文詳細分析了 .wxapkg 解包後的各文件結構,並介紹了如何通過腳本「一鍵還原」得到任意小程序的源碼。
對於一些簡單的,且使用微信官方介紹的原生開發方式開發的小程序,用上述工具基本可以直接還原得到可運行的源碼,但是對於一些邏輯複雜,或者使用 WePY、Vue 等一些框架開發的小程序,還原後的源碼可能會有一些小問題,需要我們人肉去分析解決。
後續本文對小程序源碼「編譯」後的各文件內容結構及用途的分析相對比較零散,而且沒有對各文件的依賴關係及加載邏輯進行研究,後續我們再寫一些文章講解微信客戶端是如何解析加載小程序 .wxapkg 包並運行起來。
參考連結