Build

For the Runtime Debugger + Source Code package, please refer to this Build document.

xmake

Xmake is a lightweight cross-platform build utility based on Lua. Please install xmake according to the https://xmake.io/#/guide/installation.

web

1. Install emscripten. https://emscripten.org/docs/getting_started/downloads.html

2. Unzip Assets/RuntimeDebugger/code/RuntimeDebugger-src.zip

3. Locate the xmake.lua file and execute the command in the same level directory.

xmake f -y -p wasm --links=websocket.js
xmake

4. Package the file under build/wasm/x64/release/ in zip format and name it debugger_web.bytes.

5. Replace the Assets/RuntimeDebugger/Resource/debugger_web.bytes file

xhv

1. Unzip Assets/RuntimeDebugger/code/xhv-src.zip

2. Locate the xmake.lua file and execute the command in the same level directory.Here is an example of a windows platform.

xmake f -p windows -a x64 -y
xmake -v -y xhv

3. macos

#macos 
#x86 
xmake -v -y xhv
#arm64
xmake f -v -y -a arm64
# Create dynamic library files that run natively on Apple silicon and Intel-based Mac computers.
lipo -create xhv/build/macosx/arm64/release/libxhv.dylib xhv/build/macosx/x86_64/release/libxhv.dylib -output xhv/build/macosx/libxhv.dylib

3. For other platform commands, refer to xmake's documentation for details.

#linux
xmake -v -y xhv
#android arm64-v8a
xmake f -p android --ndk=$ANDROID_NDK_HOME -a arm64-v8a -y
xmake -v -y xhv
#android armeabi-v7a
xmake f -p android --ndk=$ANDROID_NDK_HOME -a armeabi-v7a -y
xmake -v -y xhv
#ios arm64
xmake f -p iphoneos -a arm64 -y
xmake -v -y xhv

4. Replace the dynamic libraries of each platform in the Assets/RuntimeDebugger/Plugins folder.

5. iOS platform static library supplement. rd_ios_patch.unitypackage

The current plug-in uses two external libraries and needs to generate static library files for the arm64 architecture of the ios platform.Then find the static library and copy it into the Assets/RuntimeDebugger/Plugins/iphoneos/arm64/release folder. Select the iOS platform and ARM64 architecture in Unity.

xrepo install -p iphoneos -a arm64 libhv
xrepo install -p iphoneos -a arm64 miniz

xrepo packages path	@
macos/linux	~/.xmake/packages
windows	%LOCALAPPDATA%/.xmake/packages

6. Test it.