前言

簡單聊一下cocos2djs手遊的逆向，有任何相關想法歡迎和我討論^^

一些概念

列出一些個人認為比較有用的概念：

• Cocos遊戲的兩大開發工具分別是CocosCreator和CocosStudio，區別是前者是cocos2djs專用的開發工具，後者則是cocos2d-lua、cocos2d-cpp那些。

• 使用Cocos Creator 2開發的手遊，生成的關鍵so默認名稱是libcocos2djs.so
• 使用Cocos Creator 3開發的手遊，生成的關鍵so默認名稱是libcocos.so?( 入口函數非applicationDidFinishLaunching?)
• Cocos Creator在構建時可以選擇是否對.js腳本進行加密&壓縮，而加密算法固定是xxtea，還可以選擇是否使用Zip壓縮

• libcocos2djs.so裡的AppDelegate::applicationDidFinishLaunching是入口函數，可以從這裡開始進行分析
• Cocos2djs是Cocos2d-x的一個分支，因此https://github.com/cocos2d/cocos2d-x源碼同樣適用於Cocos2djs

自己寫一個Demo

自己寫一個Demo來分析的好處是能夠快速地判斷某個錯誤是由於被檢測到？還是本來就會如此？

版本信息

嘗試過2.4.2、2.4.6兩個版本，都構建失敗，最終成功的版本信息如下：

• 編輯器版本：Creator 2.4.13?( 2系列裡的最高版本，低版本在AS編譯時會報一堆錯誤 )
• ndk版本：23.1.7779620
• project/build.gradle：classpath 'com.android.tools.build:gradle:8.0.2'
• project/gradle/gradle-wrapper.properties：distributionUrl=https\://services.gradle.org/distributions/gradle-8.0.2-all.zip

Cocos Creator基礎用法

由於本人不懂cocos遊戲開發，只好直接用官方的Hello World模板。

首先要設置SDK和NDK路徑

然後構建的參數設置如下，主要需要設置以下兩點：

• 加密腳本：全都勾上，密鑰用默認的
• Source Map：保留符號，這樣IDA在打開時才能看到函數名

我使用Cocos Creator能順利構建，但無法編譯，只好改用Android Studio來編譯。

使用Android Studio打開build\jsb-link\frameworks\runtime-src\proj.android-studio，然後就可以按正常AS流程進行編譯

Demo如下所示，在中心輸出了Hello, World!。

jsc腳本解密

上述Demo構建中有一個選項是【加密腳本】，它會將js腳本通過xxtea算法加密成.jsc。

而遊戲的一些功能就會通過js腳本來實現，因此cocos2djs逆向首要事件就是將.jsc解密，通常.jsc會存放在apk內的assets目錄下

獲取解密key

方法一：從applicationDidFinishLaunching入手

方法二：HOOK

1. hook?set_xxtea_key

// soName: libcocos2djs.so
function hook_jsb_set_xxtea_key(soName) {let set_xxtea_key = Module.findExportByName(soName, "_Z17jsb_set_xxtea_keyRKNSt6__ndk112basic_stringIcNS_11char_traitsIcEENS_9allocatorIcEEEE");Interceptor.attach(set_xxtea_key,{onEnter(args){console.log("xxtea key: ", args[0].readCString())},onLeave(retval){}})
}

1. hook?xxtea_decrypt

function hook_xxtea_decrypt(soName) {let set_xxtea_key = Module.findExportByName(soName, "xxtea_decrypt");Interceptor.attach(set_xxtea_key,{onEnter(args){console.log("xxtea key: ", args[2].readCString())},onLeave(retval){}})
}

python加解密腳本

一次性解密output_dir目錄下所有.jsc，並在input_dir生成與output_dir同樣的目錄結構。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79

# pip install xxtea-py # pip install jsbeautifier import?xxtea import?gzip import?jsbeautifier import?os KEY?=?"abdbe980-786e-45" input_dir?=?r"cocos2djs_demo\assets"?# abs path output_dir?=?r"cocos2djs_demo\output"?# abs path def?jscDecrypt(data: bytes, needJsBeautifier?=?True): ????dec?=?xxtea.decrypt(data, KEY) ????jscode?=?gzip.decompress(dec).decode() ????if?needJsBeautifier: ????????return?jsbeautifier.beautify(jscode) ????else: ????????return?jscode def?jscEncrypt(data): ????compress_data?=?gzip.compress(data.encode()) ????enc?=?xxtea.encrypt(compress_data, KEY) ????return?enc def?decryptAll(): ????for?root, dirs, files?in?os.walk(input_dir): ????????? ????????# 創建與input_dir一致的結構 ????????for?dir?in?dirs: ????????????dir_path?=?os.path.join(root,?dir) ????????????target_dir?=?output_dir?+?dir_path.replace(input_dir, "") ????????????if?not?os.path.exists(target_dir): ????????????????os.mkdir(target_dir) ????????for?file?in?files: ????????????file_path?=?os.path.join(root,?file) ???????? ????????????if?not?file.endswith(".jsc"): ????????????????continue ????????????? ????????????with?open(file_path, mode?=?"rb") as f: ????????????????enc_jsc?=?f.read() ????????????? ????????????dec_jscode?=?jscDecrypt(enc_jsc) ????????????? ????????????output_file_path?=?output_dir?+?file_path.replace(input_dir, "").replace(".jsc", "") + ".js" ????????????print(output_file_path) ????????????with?open(output_file_path, mode?=?"w", encoding?=?"utf-8") as f: ????????????????f.write(dec_jscode) def?decryptOne(path): ????with?open(path, mode?=?"rb") as f: ????????enc_jsc?=?f.read() ????? ????dec_jscode?=?jscDecrypt(enc_jsc,?False) ????output_path?=?path.split(".jsc")[0]?+?".js" ????with?open(output_path, mode?=?"w", encoding?=?"utf-8") as f: ????????f.write(dec_jscode) def?encryptOne(path): ????with?open(path, mode?=?"r", encoding?=?"utf-8") as f: ????????jscode?=?f.read() ????enc_data?=?jscEncrypt(jscode) ????? ????output_path?=?path.split(".js")[0]?+?".jsc" ????with?open(output_path, mode?=?"wb") as f: ????????f.write(enc_data) if?__name__?==?"__main__": ????decryptAll()

jsc文件的2種讀取方式

為實現對遊戲正常功能的干涉，顯然需要修改遊戲執行的js腳本。而替換.jsc文件是其中一種思路，前提是要找到讀取.jsc文件的地方。

方式一：從apk裡讀取

我自己編譯的Demo就是以這種方式讀取/data/app/XXX/base.apk裡assets目錄內的.jsc文件。

cocos引擎默認使用xxtea算法來對.jsc等腳本進行加密，因此讀取.jsc的操作定然在xxtea_decrypt之前。

跟cocos2d-x源碼，找使用xxtea_decrypt的地方，可以定位到LuaStack::luaLoadChunksFromZIP

向上跟會發現它的bytes數據是由getDataFromFile函數獲取

繼續跟getDataFromFile的邏輯，它會調用getContents，而getContents裡是調用fopen來打開，但奇怪的是hook?fopen卻沒有發現它有打開任何.jsc文件

後來發現調用的並非FileUtils::getContents，而是FileUtilsAndroid::getContents。

它其中一個分支是調用libandroid.so的AAsset_read來讀取.jsc數據，調用AAssetManager_open來打開.jsc文件。

繼續對AAssetManager_open進行深入分析(?在線源碼?)，目的是找到能夠IO重定向的點：

AAssetManager_open裡調用了AssetManager::open函數

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30

// frameworks/base/native/android/asset_manager.cpp AAsset* AAssetManager_open(AAssetManager* amgr,?const?char* filename,?int?mode) { ????Asset::AccessMode amMode; ????switch?(mode) { ????case?AASSET_MODE_UNKNOWN: ????????amMode = Asset::ACCESS_UNKNOWN; ????????break; ????case?AASSET_MODE_RANDOM: ????????amMode = Asset::ACCESS_RANDOM; ????????break; ????case?AASSET_MODE_STREAMING: ????????amMode = Asset::ACCESS_STREAMING; ????????break; ????case?AASSET_MODE_BUFFER: ????????amMode = Asset::ACCESS_BUFFER; ????????break; ????default: ????????return?NULL; ????} ????AssetManager* mgr =?static_cast<AssetManager*>(amgr); ????// here ????Asset* asset = mgr->open(filename, amMode); ????if?(asset == NULL) { ????????return?NULL; ????} ????return?new?AAsset(asset); }

AssetManager::open調用openNonAssetInPathLocked

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22

// frameworks/base/libs/androidfw/AssetManager.cpp Asset* AssetManager::open(const?char* fileName, AccessMode mode) { ????AutoMutex _l(mLock); ????LOG_FATAL_IF(mAssetPaths.size() == 0,?"No assets added to AssetManager"); ????String8 assetName(kAssetsRoot); ????assetName.appendPath(fileName); ????size_t?i = mAssetPaths.size(); ????while?(i > 0) { ????????i--; ????????ALOGV("Looking for asset '%s' in '%s'\n", ????????????????assetName.string(), mAssetPaths.itemAt(i).path.string()); ????????// here ????????Asset* pAsset = openNonAssetInPathLocked(assetName.string(), mode, mAssetPaths.itemAt(i)); ????????if?(pAsset != NULL) { ????????????return?pAsset != kExcludedAsset ? pAsset : NULL; ????????} ????} ????return?NULL; }

AssetManager::openNonAssetInPathLocked先判斷assets是位於.gz還是.zip內，而.apk與.zip基本等價，因此理應會走else分支。

1	奇怪的是當我使用frida hook驗證時，能順利hook到`openAssetFromZipLocked`，卻hook不到`getZipFileLocked`，顯然是不合理的。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47

// frameworks/base/libs/androidfw/AssetManager.cpp Asset* AssetManager::openNonAssetInPathLocked(const?char* fileName, AccessMode mode, ????const?asset_path& ap) { ????Asset* pAsset = NULL; ????if?(ap.type == kFileTypeDirectory) { ????????String8 path(ap.path); ????????path.appendPath(fileName); ????????pAsset = openAssetFromFileLocked(path, mode); ????????if?(pAsset == NULL) { ????????????/* try again, this time with ".gz" */ ????????????path.append(".gz"); ????????????pAsset = openAssetFromFileLocked(path, mode); ????????} ????????if?(pAsset != NULL) { ????????????//printf("FOUND NA '%s' on disk\n", fileName); ????????????pAsset->setAssetSource(path); ????????} ????// run this branch ????}?else?{ ????????String8 path(fileName); ????????????????// here ????????ZipFileRO* pZip = getZipFileLocked(ap); ????????if?(pZip != NULL) { ????????????ZipEntryRO entry = pZip->findEntryByName(path.string()); ????????????if?(entry != NULL) { ????????????????? ????????????????pAsset = openAssetFromZipLocked(pZip, entry, mode, path); ????????????????pZip->releaseEntry(entry); ????????????} ????????} ????????if?(pAsset != NULL) { ????????????pAsset->setAssetSource( ????????????????????createZipSourceNameLocked(ZipSet::getPathName(ap.path.string()), String8(""), ????????????????????????????????????????????????String8(fileName))); ????????} ????} ????return?pAsset; }

嘗試繼續跟剛剛hook失敗的AssetManager::getZipFileLocked，它調用的是AssetManager::ZipSet::getZip。

1	同樣用frida hook `getZip`，這次成功了，猜測是一些優化移除了`getZipFileLocked`而導致hook 失敗。

1 2 3 4 5 6 7

// frameworks/base/libs/androidfw/AssetManager.cpp ZipFileRO* AssetManager::getZipFileLocked(const?asset_path& ap) { ????ALOGV("getZipFileLocked() in %p\n",?this); ????return?mZipSet.getZip(ap.path); }

ZipSet::getZip會調用SharedZip::getZip，後者直接返回mZipFile。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16

// frameworks/base/libs/androidfw/AssetManager.cpp ZipFileRO* AssetManager::ZipSet::getZip(const?String8& path) { ????int?idx = getIndex(path); ????sp<SharedZip> zip = mZipFile[idx]; ????if?(zip == NULL) { ????????zip = SharedZip::get(path); ????????mZipFile.editItemAt(idx) = zip; ????} ????return?zip->getZip(); } ZipFileRO* AssetManager::SharedZip::getZip() { ????return?mZipFile; }

尋找mZipFile賦值的地方，最終會找到是由ZipFileRO::open(mPath.string())賦值。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

// frameworks/base/libs/androidfw/AssetManager.cpp AssetManager::SharedZip::SharedZip(const?String8& path,?time_t?modWhen) ????: mPath(path), mZipFile(NULL), mModWhen(modWhen), ??????mResourceTableAsset(NULL), mResourceTable(NULL) { ????if?(kIsDebug) { ????????ALOGI("Creating SharedZip %p %s\n",?this, (const?char*)mPath); ????} ????ALOGV("+++ opening zip '%s'\n", mPath.string()); ????// here ????mZipFile = ZipFileRO::open(mPath.string()); ????if?(mZipFile == NULL) { ????????ALOGD("failed to open Zip archive '%s'\n", mPath.string()); ????} }

1	從`frameworks/base/libs/androidfw/Android.bp`可知上述代碼的lib文件是`libandroidfw.so`，位於`/system/lib64/`下。將其pull到本地然後用IDA打開，就能根據IDA所示的函數導出名稱/地址對這些函數進行hook。

方式二：從應用的數據目錄裡讀取

無論是方式一還是方式二，.jsc數據都是通過getDataFromFile獲取。而getDataFromFile裡調用了getContents。

1	getDataFromFile -> getContents

在方式一中，我一開始看的是FileUtils::getContents，但其實是FileUtilsAndroid::getContents才對。

只有當fullPath[0] == '/'時才會調用FileUtils::getContents，而FileUtils::getContents會調用fopen來打開.jsc

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

// https://github.com/cocos2d/cocos2d-x/blob/76903dee64046c7bfdba50790be283484b4be271/cocos/platform/android/CCFileUtils-android.cpp FileUtils::Status FileUtilsAndroid::getContents(const?std::string& filename, ResizableBuffer* buffer)?const { ????static?const?std::string apkprefix("assets/"); ????if?(filename.empty()) ????????return?FileUtils::Status::NotExists; ????string fullPath = fullPathForFilename(filename); ????if?(fullPath[0] ==?'/') ????????????// here ????????return?FileUtils::getContents(fullPath, buffer); ????????? ????// 方式一會走這裡.... }

替換思路

正常來說有以下幾種替換腳本的思路：

1. 找到讀取.jsc文件的地方進行IO重定向。

2. 直接進行字節替換，即替換xxtea_decypt解密前的.jsc字節數據，或者替換xxtea_decypt解密後的明文.js腳本。

   這裡的替換是指開闢一片新內存，將新的數據放到這片內存，然後替換指針的指向。

3. 直接替換apk裡的.jsc，然後重打包apk。

4. 替換js明文，不是像2那樣開闢一片新內存，而是直接修改原本內存的明文js數據。

經測試後發現只有1、3、4是可行的，2會導致APP卡死( 原因不明？？？ )。

思路一實現

從上述可知第一種.jsc讀取方式會先調用ZipFileRO::open(mPath.string())來打開apk，之後再通過AAssetManager_open來獲取.jsc。

hook?ZipFileRO::open看看傳入的參數是什麼。

function hook_ZipFile_open(flag) {let ZipFile_open = Module.getExportByName("libandroidfw.so", "_ZN7android9ZipFileRO4openEPKc"); console.log("ZipFile_open: ", ZipFile_open)return Interceptor.attach(ZipFile_open,{onEnter: function (args) {console.log("arg0: ", args[0].readCString());},onLeave: function (retval) {}});
}

可以看到其中一條是當前APK的路徑，顯然assets也是從這裡取的，因此這裡是一個可以嘗試重定向點，先需構造一個fake.apk?push 到/data/app/XXX/下，然後hook IO重定向到fake.apk實現替換。

對我自己編譯的Demo而言，無論是以apktool解包&重打包的方式，還是直接解壓縮&重壓縮&手動命名的方式來構建fake.apk都是可行的，但要記得賦予fake.apk最低644的權限。

以下是我使用上述方法在我的Demo中實踐的效果，成功修改中心的字符串。

但感覺這種方式的實用性較低( 什至不如直接重打包… )

思路二嘗試(失敗)

連這樣僅替換指針指向都會導致APP卡死？？

function hook_xxtea_decrypt() {Interceptor.attach(Module.findExportByName("libcocos2djs.so", "xxtea_decrypt"), {onEnter(args) {let jsc_data = args[0];let size = args[1].toInt32();let key = args[2].readCString();let key_len = args[3].toInt32();this.arg4 = args[4];let target_list = [0x15, 0x43, 0x73];let flag = true;for (let i = 0; i < target_list.length; i++) {if (target_list[i] != Memory.readU8(jsc_data.add(i))) {flag = false;}}this.flag = flag;if (flag) {let new_size = size;let newAddress = Memory.alloc(new_size);Memory.protect(newAddress, new_size, "rwx")Memory.protect(args[0], new_size, "rwx")Memory.writeByteArray(newAddress, jsc_data.readByteArray(new_size))args[0] = newAddress;}},onLeave(retval) {}})}

思路四實現

參考這位大佬的文章可知cocos2djs內置的v8引擎最終通過evalString來執行.jsc解密後的js代碼。

在正式替換前，最好先通過hook?evalString的方式保存一份目標js( 因為遊戲的熱更新策略等原因，可能導致evalString執行的js代碼與你從apk裡手動解密.jsc得到的js腳本有所不同 )。

function saveJscode(jscode, path) {var fopenPtr = Module.findExportByName("libc.so", "fopen");var fopen = new NativeFunction(fopenPtr, 'pointer', ['pointer', 'pointer']);var fclosePtr = Module.findExportByName("libc.so", "fclose");var fclose = new NativeFunction(fclosePtr, 'int', ['pointer']);var fseekPtr = Module.findExportByName("libc.so", "fseek");var fseek = new NativeFunction(fseekPtr, 'int', ['pointer', 'int', 'int']);var ftellPtr = Module.findExportByName("libc.so", "ftell");var ftell = new NativeFunction(ftellPtr, 'int', ['pointer']);var freadPtr = Module.findExportByName("libc.so", "fread");var fread = new NativeFunction(freadPtr, 'int', ['pointer', 'int', 'int', 'pointer']);var fwritePtr = Module.findExportByName("libc.so", "fwrite");var fwrite = new NativeFunction(fwritePtr, 'int', ['pointer', 'int', 'int', 'pointer']);let newPath = Memory.allocUtf8String(path);let openMode = Memory.allocUtf8String('w');let str = Memory.allocUtf8String(jscode);let file = fopen(newPath, openMode);if (file != null) {fwrite(str, jscode.length, 1, file)fclose(file);}return null;
}function hook_evalString() {Interceptor.attach(Module.findExportByName("libcocos2djs.so", "_ZN2se12ScriptEngine10evalStringEPKclPNS_5ValueES2_"), {onEnter(args) {let path = args[4].readCString();path = path == null ? "" : path;let jscode = args[1];let size = args[2].toInt32();if (path.indexOf("assets/script/index.jsc") != -1) {saveJscode(jscode.readCString(), "/data/data/XXXXXXX/test.js");}}})
}

利用Memory.scan來找到修改的位置

function findReplaceAddr(startAddr, size, pattern) {Memory.scan(startAddr, size, pattern, {onMatch(address, size) {console.log("target offset: ", ptr(address - startAddr))return 'stop';},onComplete() {console.log('Memory.scan() complete');}});
}function hook_evalString() {Interceptor.attach(Module.findExportByName("libcocos2djs.so", "_ZN2se12ScriptEngine10evalStringEPKclPNS_5ValueES2_"), {onEnter(args) {let path = args[4].readCString();path = path == null ? "" : path;let jscode = args[1];let size = args[2].toInt32();if (path.indexOf("assets/script/index.jsc") != -1) {let pattern = "76 61 72 20 65 20 3D 20 64 2E 50 6C 61 79 65 72 41 74 74 72 69 62 75 74 65 43 6F 6E 66 69 67 2E 67 65 74 44 72 65 61 6D 48 6C 70 65 49 74 65 6D 44 72 6F 70 28 29 2C";findReplaceAddr(jscode, size, pattern);}}})
}

最後以Memory.writeU8來逐字節修改，不用Memory.writeUtf8String的原因是它默認會在最終添加'\0'而導致報錯。

function replaceEvalString(jscode, offset, replaceStr) {for (let i = 0; i < replaceStr.length; i++) {Memory.writeU8(jscode.add(offset + i), replaceStr.charCodeAt(i))}
}// 例:
function cheatAutoChopTree(jscode) {let replaceStr = 'true || "                                 "';replaceEvalString(jscode, 0x3861f6, replaceStr)
}

某砍樹手遊實踐

以某款砍樹遊戲來進行簡單的實踐。

遊戲有自動砍樹的功能，但需要符合一定條件

如何找到對應的邏輯在哪個.jsc中？直接搜字符串就可以。

利用上述替換思路4來修改對應的js判斷邏輯，最終效果：

結語

思路4那種替換手段有大小限制，不能隨意地修改，暫時還未找到能隨意修改的手段，有知道的大佬還請不嗇賜教，有任何想法也歡迎交流^^

後記

在評論區的一位大佬指點下，終於是找到一種更優的替換方案，相比起思路4來說要方便太多了。
最開始時我其實也嘗試過這種直接的js明文替換，但APP會卡死/閃退，現在才發現是frida的api所致，那時在開辟內存空間時使用了Memory.alloc、Memory.allocUtf8String，改成使用libc.so的malloc就不會閃退了，具體為什麼會這樣我也不清楚，看看以後有沒有機會研究下frida的源碼吧^^