萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Lua 自動化打包 APK 腳本:Cocos2d-x + Lua 專案實戰

背景

早期用 .bat 打包 APK,語法彆扭、擴展性差。改用 Lua 腳本,享有完整程式語言能力:模組化、錯誤處理、跨平台路徑處理。適用於 **Cocos2d-x + Lua** 專案。

核心流程

  1. 設定工具鏈路徑(JDK、Ant、Android SDK/NDK、SVN)。
  2. 設定專案路徑(引擎、工作目錄、Resources、Assets)。
  3. 清理舊 assets/ 與舊 APK。
  4. SVN 更新引擎與專案代碼(可選)。
  5. LuaJIT 編譯:遍歷 Resources/,.lua → luac 位元碼,其他檔案直接複製至 Resources_jit/。
  6. ASMaker 加密:加密 Resources_jit/ 輸出至 assets/。
  7. NDK Build:編譯 C++ 共享庫(ndk-build)。
  8. Android 專案更新:android update project。
  9. Ant Release:產出簽名 .apk。

關鍵輔助函式(節錄)

-- 路徑存在檢查
local function dir_exist(dir)
    return os.execute(string.format('pushd "%s" >nul 2>&1 && popd', dir)) == 0
end

-- 執行命令並捕獲輸出
local function run_one_cmd(cmd)
    local handle = io.popen(cmd)
    local result = handle:read("*a")
    handle:close()
    return result
end

-- LuaJIT 編譯單檔
local function jit_file(work_dir, src, dst)
    local cmd = string.format('luajit -b "%s" "%s"', src, dst)
    local ok = os.execute(cmd)
    if ok ~= 0 then error("LuaJIT 失敗: " .. src) end
end

完整腳本架構(精簡版)

require('support')  -- 載入上述輔助函式

-- === 1. 工具路徑 ===
local JAVA_HOME   = [[C:\Program Files\Java\jdk1.8.0_05]]
local ANT_HOME    = [[D:\ProgramSoftware\apache-ant-1.9.4]]
local ANDROID_HOME= [[D:\ProgramSoftware\android-sdk]]
local NDK_HOME    = [[D:\ProgramSoftware\android-ndk-r9d]]
local SVN_HOME    = [[C:\Program Files\TortoiseSVN\bin]]

-- === 2. 專案路徑 ===
local ENGINE_DIR  = [[D:\engine]]
local WORK_DIR    = [[D:\engine\projects\XXXX\proj.android]]
local RES_DIR     = WORK_DIR .. [[\..\Resources]]
local ASSETS_DIR  = WORK_DIR .. [[\assets]]

-- === 3. 清理 ===
if dir_exist(ASSETS_DIR) then rmdir(ASSETS_DIR) end
-- 刪除舊 APK ...

-- === 4. LuaJIT ===
local cmd = string.format('dir /b /s "%s"', RES_DIR)
for line in io.popen(cmd):lines() do
    local to = line:gsub('Resources', 'Resources_jit')
    if dir_exist(line) then check_mk_path(to)
    elseif line:match('%.lua$') then jit_file(WORK_DIR, line, to)
    else copy_file(line, to) end
end

-- === 5. ASMaker 加密 ===
local enc_cmd = string.format('%sASMaker.exe -i "%sResources_jit" -o "%sassets" -f .lua -e .exe',
    WORK_DIR, WORK_DIR, WORK_DIR)
assert(run_one_cmd(enc_cmd):find("失敗") == nil, "加密失敗")

-- === 6. NDK Build ===
local ndk_cmd = string.format('call "%sndk-build" -C "%s" NDK_MODULE_PATH="%s;%s"',
    NDK_HOME, WORK_DIR, ENGINE_DIR, ENGINE_DIR..[[cocos2dx\platform\third_party\android\prebuilt]])
assert(run_one_cmd(ndk_cmd):find("error") == nil, "NDK Build 失敗")

-- === 7. Android Update ===
os.execute('call "'..ANDROID_HOME..[[tools\android" update project -p "]]..WORK_DIR..[["))
os.execute('call "'..ANDROID_HOME..[[tools\android" update lib-project -p "]]..ENGINE_DIR..[[cocos2dx\platform\android\java"]])

-- === 8. Ant Release ===
local ant_cmd = string.format('pushd "%s" && call "%sbin\ant" release', WORK_DIR, ANT_HOME)
assert(run_one_cmd(ant_cmd):find("failed") == nil, "Ant 打包失敗")

print("✅ APK 產出成功!")

擴充建議

  • 加入 argparse 支援命令列參數(建構類型、版本號、簽名金鑰)。
  • 整合 zipalign、apksigner 完成正式簽名流程。
  • 並行化 LuaJIT 編譯(lanes 或多進程)加速大型專案。
  • 輸出 JSON 構建報告供 CI 系統解析。

結語

Lua 腳本化打包流程,讓構建邏輯可讀、可測、可維護。下一步:接入 Jenkins/GitLab CI,實現「推代碼 → 自動產出 APK」的完整 CI/CD 管線。

copyright © 萬盛學電腦網 all rights reserved