編譯 Luajit 庫,的確是一個挑戰。因為官網的教程,在當前版本的 Xcode 和 NDK 環境中,已經不適用了。以前只是編譯了適用於真機的 Luajit 庫。最近在嘗試編譯模擬器 Luajit 庫,就順便梳理了下 Luajit 庫的編譯經驗,供以後查閱。網上的討論也是有一些,但是相當一部分都已經... ...
編譯 Luajit 庫,的確是一個挑戰。因為官網的教程,在當前版本的 Xcode 和 NDK 環境中,已經不適用了。以前只是編譯了適用於真機的 Luajit 庫。最近在嘗試編譯模擬器 Luajit 庫,就順便梳理了下 Luajit 庫的編譯經驗,供以後查閱。網上的討論也是有一些,但是相當一部分都已經過時。或許等你看到這篇文章的時候,可能也只是能獲得一些可能的經驗來解決自己的編譯問題。所以說,瞭解一些基本的編譯知識,能勉強看懂 Luajit 的 make 文件,還是很有必要的。本篇是關於 Luajit 靜態庫的,如果你想找的是如何編譯適用於移動端的 Luajit 位元組碼,可以直接看 【最新】LuaJIT 32/64 位位元組碼,從編譯到使用全紀錄。
編譯環境
等你試著自己交叉編譯 Luajit 庫時,就會明白環境的影響到底有多大。
macOS 10.13.4
Xcode 9.4.1
Android Studio 3.1.3
先約定下基本的路徑信息,供下文使用
├── LuaJIT-2.1.0-beta3
├── build-android.sh
├── build-ios.sh
├── lib
│ ├── android
│ │ ├── arm64-v8a
│ │ ├── armeabi
│ │ ├── armeabi-v7a
│ │ └── x86
│ └── ios
│ └── libluajit2.1.0-beta.3.a
編譯適用於 iOS 的 Luajit 庫,可能會遇到的問題
編譯前的準備
需要先把 Luajit 源碼的 lj_arch.h 547 行,從
#if LJ_TARGET_CONSOLE || (LJ_TARGET_IOS && __IPHONE_OS_VERSION_MIN_REQUIRED >= __IPHONE_8_0)
#define LJ_NO_SYSTEM 1
#endif
改為:
#define LJ_NO_SYSTEM 1
否則會觸發錯誤:
./lib_os.c:52:14: error: 'system' is unavailable: not available on iOS
問題的原因大致是,此處的判斷,已經在最新的 Xcode 極其編譯環境中,無法爭取工作。對此問題的根源感興趣的童鞋,請自行閱讀 Luajit 的 make 文件。
註意:編譯 Android 或其他平臺庫時,不需要修改此處源碼。
完整的 iOS 編譯命令: build-ios.sh
建議最好以 sh 文件的方式,直接執行,在命令行輸入,可能會觸發詭異的未知問題。其中一個很關鍵的原因是: 在複製粘貼指令時,部分文本編輯器(比如 mac 上的備忘錄)會混入特殊字元,導致編譯指令運行失敗。
#!/bin/bash
# LuaJIT 的源碼路徑
LUAJIT=./LuaJIT-2.1.0-beta3
XCODEPATH=`xcode-select -print-path`
DEVDIR=$XCODEPATH/Platforms
IOSVER=iPhoneOS.sdk
SIMVER=iPhoneSimulator.sdk
# 庫的最總名稱
LIBNAME=libluajit2.1.0-beta.3.a
# iOS 最低相容版本,最好與需要嵌入 LuaJIT 的 App 的最低相容設置保持一致.
MINVERSION=9.0
IOSDIR=$DEVDIR/iPhoneOS.platform/Developer
SIMDIR=$DEVDIR/iPhoneSimulator.platform/Developer
# xctoolchain 可以使用 xcode-select --install 命令安裝.
# xctoolchain 和模擬器中, 目前已不包含 gcc 等命令,可以從系統其它位置複製到 $IOSBIN 目錄.
# 命令的具體路徑,可以執行 xcodebuild -find gcc 獲得.
IOSBIN=$XCODEPATH/Toolchains/XcodeDefault.xctoolchain/usr/bin/
SIMBIN=$SIMDIR/usr/bin/
BUILD_DIR=$LUAJIT/build
rm -rf $BUILD_DIR
mkdir -p $BUILD_DIR
rm *.a 1>/dev/null 2>/dev/null
echo =================================================
echo ARMV7 Architecture
ISDKF="-arch armv7 -isysroot $IOSDIR/SDKs/$IOSVER -miphoneos-version-min=$MINVERSION"
make -j -C $LUAJIT HOST_CC="gcc -m32 " CROSS=$IOSBIN TARGET_FLAGS="$ISDKF" TARGET=armv7 TARGET_SYS=iOS clean
make -j -C $LUAJIT HOST_CC="gcc -m32 " CROSS=$IOSBIN TARGET_FLAGS="$ISDKF" TARGET=armv7 TARGET_SYS=iOS
mv $LUAJIT/src/libluajit.a $BUILD_DIR/libluajitA7.a
echo =================================================
echo ARM64 Architecture
ISDKF="-arch arm64 -isysroot $IOSDIR/SDKs/$IOSVER -miphoneos-version-min=$MINVERSION"
make -j -C $LUAJIT HOST_CC="gcc " CROSS=$IOSBIN TARGET_FLAGS="$ISDKF" TARGET=arm64 TARGET_SYS=iOS clean
make -j -C $LUAJIT HOST_CC="gcc " CROSS=$IOSBIN TARGET_FLAGS="$ISDKF" TARGET=arm64 TARGET_SYS=iOS
mv $LUAJIT/src/libluajit.a $BUILD_DIR/libluajit64bit.a
echo =================================================
echo IOS Simulator Architecture
ISDKF="-arch x86_64 -isysroot $SIMDIR/SDKs/$SIMVER -miphoneos-version-min=$MINVERSION"
make -j -C $LUAJIT HOST_CFLAGS="-arch x86_64" HOST_LDFLAGS="-arch x86_64" TARGET_SYS=iOS TARGET=x86_64 clean
make -j -C $LUAJIT HOST_CFLAGS="-arch x86_64" HOST_LDFLAGS="-arch x86_64" TARGET_SYS=iOS TARGET=x86_64 amalg CROSS=$SIMBIN TARGET_FLAGS="$ISDKF"
mv $LUAJIT/src/libluajit.a $BUILD_DIR/libluajitx86_64.a
libtool -o $BUILD_DIR/$LIBNAME $BUILD_DIR/*.a 2> /dev/null
mkdir -p $BUILD_DIR/Headers
cp $LUAJIT/src/lua.h $BUILD_DIR/Headers
cp $LUAJIT/src/lauxlib.h $BUILD_DIR/Headers
cp $LUAJIT/src/lualib.h $BUILD_DIR/Headers
cp $LUAJIT/src/luajit.h $BUILD_DIR/Headers
cp $LUAJIT/src/lua.hpp $BUILD_DIR/Headers
cp $LUAJIT/src/luaconf.h $BUILD_DIR/Headers
mv $BUILD_DIR/$LIBNAME ./lib/ios
rm -rf $BUILD_DIR
cd $LUAJIT
make clean
cd ..
編譯腳本運行方法:
chmod a+x build-ios.sh
./build-ios.sh
其他可能遇到的問題
/Applications/Xcode.app/Contents/Developer/Platforms/Toolchains/XcodeDefault.xctoolchain/usr/bin/gcc command not found
1> 先安裝 toolchains:
xcode-select --install
2> 找下缺失本機上對應命令的真實路徑:
xcodebuild -find gcc
3> 如果能找到,就把命令複製到缺失命令的位置;如果本機找不到,就從網上搜下安裝教程。
針對模擬器的額外設置
由於iphone5s以上虛擬機需要x86_64支持,luajit為了支持此模式需要在other linker flags中增加參數(註意,只需要對模擬器添加參數,針對ios不能添加,否則apple不會通過審核):
-pagezero_size 10000 -image_base 100000000
網上類似的描述很多,也很準確,我想補充的是:最好只在 Debug 模式下的配置中增加上述特殊參數。
另外,如果你已經在使用 Luajit 的位元組碼,請註意模擬器 Luajit 庫,需要載入的是 32 位位元組碼。
編譯適用於 Android 的 Luajit 庫,可能會遇到的問題
完整的 Android 編譯命令: build-android.sh
#!/bin/bash
# LuaJIT 的源碼路徑
LUAJIT=./LuaJIT-2.1.0-beta3
cd $LUAJIT
#編譯 android-x86
make clean
NDK=~/library/android/sdk/ndk-bundle
NDKABI=17
NDKTRIPLE=x86
NDKVER=$NDK/toolchains/$NDKTRIPLE-4.9
NDKP=$NDKVER/prebuilt/darwin-x86_64/bin/i686-linux-android-
NDKF="-isystem $NDK/sysroot/usr/include/i686-linux-android -D__ANDROID_API__=$NDKABI -D_FILE_OFFSET_BITS=32"
NDK_SYSROOT_BUILD=$NDK/sysroot
NDK_SYSROOT_LINK=$NDK/platforms/android-$NDKABI/arch-x86
make HOST_CC="gcc-4.9 -m32" CROSS=$NDKP TARGET_FLAGS="$NDKF" TARGET_SYS=Linux TARGET_SHLDFLAGS="--sysroot $NDK_SYSROOT_LINK" TARGET_LDFLAGS="--sysroot $NDK_SYSROOT_LINK" TARGET_CFLAGS="--sysroot $NDK_SYSROOT_BUILD"
mv ./src/libluajit.a "../lib/android/x86/libluajit.a"
#編譯 android-armeabi
make clean
NDK=~/Library/Android/sdk/ndk-bundle
NDKABI=17
NDKTRIPLE=arm-linux-androideabi
NDKVER=$NDK/toolchains/$NDKTRIPLE-4.9
NDKP=$NDKVER/prebuilt/darwin-x86_64/bin/$NDKTRIPLE-
NDKF="-isystem $NDK/sysroot/usr/include/$NDKTRIPLE -D__ANDROID_API__=$NDKABI -D_FILE_OFFSET_BITS=32"
NDK_SYSROOT_BUILD=$NDK/sysroot
NDK_SYSROOT_LINK=$NDK/platforms/android-$NDKABI/arch-arm
make HOST_CC="gcc-4.9 -m32" CROSS=$NDKP TARGET_FLAGS="$NDKF" TARGET_SYS=Linux TARGET_SHLDFLAGS="--sysroot $NDK_SYSROOT_LINK" TARGET_LDFLAGS="--sysroot $NDK_SYSROOT_LINK" TARGET_CFLAGS="--sysroot $NDK_SYSROOT_BUILD"
mv ./src/libluajit.a ../lib/android/armeabi/libluajit.a
#編譯 android-armeabi-v7a
make clean
NDK=~/Library/Android/sdk/ndk-bundle
NDKABI=17
NDKTRIPLE=arm-linux-androideabi
NDKVER=$NDK/toolchains/$NDKTRIPLE-4.9
NDKP=$NDKVER/prebuilt/darwin-x86_64/bin/$NDKTRIPLE-
NDKF="-isystem $NDK/sysroot/usr/include/$NDKTRIPLE -D__ANDROID_API__=$NDKABI -D_FILE_OFFSET_BITS=32"
NDK_SYSROOT_BUILD=$NDK/sysroot
NDK_SYSROOT_LINK=$NDK/platforms/android-$NDKABI/arch-arm
NDKARCH="-march=armv7-a -mfloat-abi=softfp -Wl,--fix-cortex-a8"
make HOST_CC="gcc-4.9 -m32" CROSS=$NDKP TARGET_FLAGS="$NDKF $NDKARCH" TARGET_SYS=Linux TARGET_SHLDFLAGS="--sysroot $NDK_SYSROOT_LINK" TARGET_LDFLAGS="--sysroot $NDK_SYSROOT_LINK" TARGET_CFLAGS="--sysroot $NDK_SYSROOT_BUILD"
mv ./src/libluajit.a ../lib/android/armeabi-v7a/libluajit.a
#編譯 android-arm64-v8a
make clean
NDK=~/Library/Android/sdk/ndk-bundle
NDKABI=21
NDKTRIPLE=aarch64-linux-android
NDKVER=$NDK/toolchains/$NDKTRIPLE-4.9
NDKP=$NDKVER/prebuilt/darwin-x86_64/bin/$NDKTRIPLE-
NDKF="-isystem $NDK/sysroot/usr/include/$NDKTRIPLE -D__ANDROID_API__=$NDKABI"
NDK_SYSROOT_BUILD=$NDK/sysroot
NDK_SYSROOT_LINK=$NDK/platforms/android-$NDKABI/arch-arm64
make HOST_CC="gcc-4.9" CROSS=$NDKP TARGET_FLAGS="$NDKF" TARGET_SYS=Linux TARGET_SHLDFLAGS="--sysroot $NDK_SYSROOT_LINK" TARGET_LDFLAGS="--sysroot $NDK_SYSROOT_LINK" TARGET_CFLAGS="--sysroot $NDK_SYSROOT_BUILD"
mv ./src/libluajit.a ../lib/android/arm64-v8a/libluajit.a
make clean
註意:此處共編譯了 arm64-v8a,armeabi-v7a,armeabi,x86 四種CPU架構的庫。其中 arm64-v8a 並沒有使用,因為它會引起詭異的相容適配問題。初步懷疑和不同廠商魔改 ROM 實現有關。期待看到小伙伴們的進一步深入解讀~
參考文章:
https://github.com/rampantpixels/lua_lib/blob/master/lua/luajit/build-ios.sh
https://github.com/cailei/luajit/blob/master/build-luajit-ios.sh