快速开始1.安装 PowerShell 7Windows安装 PowerShell 7。执行策略Windows 必需如果是克隆的 Axmol 仓库Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force如果是下载的 ZIP 发行版建议在下载后验证 MD5 或 SHA256 摘要Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy Bypass -Force⚠️ 注意RemoteSigned比Bypass更安全。macOS / Linux直接运行setup.ps1。提示setup.ps1在 macOS/Linux 上也可以用bash 模式执行。2.安装编译工具链Windows: 安装Visual Studio 2022 或 2026并勾选Desktop development with C工作负载。如果需要 UWP 开发还需启用WinUI application development tools工作负载并勾选可选组件C Universal Windows Platform tools。macOS:对于axmol-v2安装Xcode 14.2 或更高版本—— 注意Xcode 14.2 仅支持在macOS 12.5 ~ macOS 13.x上运行。对于axmol-v3安装Xcode 16.4 或更高版本其要求macOS 15.3 或更新版本。Linux: 确保已安装 GCC/GUbuntu 22.04、Debian 12、ArchLinux。3.运行安装脚本./setup.ps1该脚本会安装依赖并配置环境变量。完成后请重启终端。在 Linux 上可能需要重新登录当前系统用户按照提示操作即可。4.创建新项目axmol new -p dev.axmol.hellocpp -d ./projects -l cpp HelloCpp-l可以是cpp或lua--portrait可选生成竖屏项目5.构建项目axmol默认会构建你开发机上的宿主目标。使用-p参数可以交叉编译到其他平台。 常用构建命令平台示例命令Windowsaxmol -p win32UWPaxmol -p winuwpLinuxaxmol -p linuxmacOS x64axmol -p osx -a x64macOS arm64axmol -p osx -a arm64iOS (模拟器)axmol -p ios -a x64 -sdk simiOS (真机)axmol -p ios -a arm64 -ctvOS (模拟器)axmol -p tvos -a arm64 -sdk simtvOS (真机)axmol -p tvos -a arm64 -cAndroid APKaxmol -p android -a arm64Android AABaxmol -p android -a arm64 -aabWASMaxmol -p wasmWASM64(需要 v3)axmol -p wasm64 常用参数-p platform指定目标平台例如win32、linux、osx、ios、android、wasm等。-a arch指定目标架构例如x64、arm64。在 macOS、iOS、tvOS、Android 等多架构平台上尤其重要。-c生成 IDE 工程文件如 Visual Studio.sln或 Xcode.xcodeproj。在 iOS/tvOS 真机构建时必须使用因为需要代码签名。-sdk name指定 SDK 类型例如sim表示模拟器构建。-aab在 Android 平台生成 AAB 包Google Play 要求默认生成 APK。-On指定构建优化等级-O0→ Debug-O1→ MinSizeRel-O2→ RelWithDebInfo默认-O3→ Release 注意事项:你可能注意到在 iOS (真机) 和 tvOS (真机) 的命令中我们加了-c参数。这是因为真机构建必须进行代码签名。目前需要打开生成的 Xcode 工程手动配置签名。axmol命令是axmol build的简写使用axmol build -h可以查看所有可用选项和详细说明。Wasm: 在所有开发操作系统macOS、Windows、Linux上均受支持。请确保已安装Python 3.13 或更高版本。 在 PowerShell 终端中运行python -V以确认当前 Python 版本之后使用axmol run -p wasm即可构建并直接启动浏览器运行你的游戏项目。Lua绑定: 运行:./tools/ci/genbindings.ps1但要求 Python 版本不得高于3.12 如果在 windows 10 较新的版本中支持winget命令可以用:winget install --id Python.Python.3.12 --version 3.12.10️ IDE 集成Axmol CLI 覆盖了大多数平台的构建需求。对于Windows / Linux / macOS (模拟器)IDE 是可选的。对于iOS/tvOS 真机IDE 是必须的因为需要在 Xcode 中进行代码签名。Visual Studio (Windows)运行axmol -c然后打开生成的解决方案文件VS2022→build/ProjectName.slnVS2026→build/ProjectName.slnxXcode (macOS/iOS/tvOS)运行axmol -p osx/ios/tvos -c然后打开生成的.xcodeproj⚠️ 对于 iOS/tvOS 真机构建必须在 Xcode 中打开工程并手动配置签名。Android Studio运行axmol -p android -c然后打开proj.android 构建签名的发布版本 (APK / AAB)适用于 CI/CD 工作流axmol -p android -a arm64 -xc -PKEY_STORE_FILE/path/to/your-app.jks,-PKEY_STORE_PASSWORDyour_key_store_passwd,-PKEY_ALIASyour_key_alias,-PKEY_PASSWORDyour_key_passwd如果需要生成带签名的 AAB 包 只需要添加参数-aab即可。⚙️ 高级配置 / 常见问题Windows Build Tools: Axmol 支持仅安装 BuildTools而不安装完整的 Visual Studio IDE。但我们强烈推荐安装Visual Studio 2022 或 2026 IDE这会为你的 Windows 平台开发带来最佳体验 —— 在我们看来它是地球上最强大的 IDE。Windows clang: 在 Windows 平台我们还支持使用 clang 构建 Win32 目标平台命令:axmol -cc clang即可。Linux: 使用VSCode并安装C和CMake Tools扩展以获得最佳开发体验。 请确保系统已安装GCC/G和CMake推荐使用 Ubuntu 22.04、Debian 12 或 ArchLinux。Android SDK/NDK:setup.ps1 -p android会安装最低版本的 NDK —axmol-v2使用r23daxmol-v3使用r27d。WASM 调试: 默认 emsdk 版本是3.1.73。调试可使用 Chrome DevTools。 总结最简流程只有三步./setup.ps1axmol newaxmol build其他步骤都是可选或高级用法。 更多帮助更多常见构建问题请查看Axmol FAQ – 构建