armorpaint/readme.md

![](https://armorpaint.org/img/git.jpg)

armorpaint
==============

[ArmorPaint](https://armorpaint.org) 是一款 3D PBR 贴图绘制软件——详见[使用手册](https://armorpaint.org/manual)。

*注意 1：本仓库面向开发者，可能不稳定。官方分发的二进制为[付费](https://armorpaint.org/download)，用于支持项目开发。所有开发都在此公开进行，以便人人可用。感谢支持！*

*注意 2：编译 ArmorPaint 的 git 版本需要安装编译器（Windows - [带 clang 工具的 Visual Studio](https://visualstudio.microsoft.com/downloads/)，Linux - [clang + 依赖](https://github.com/armory3d/armorpaint/blob/main/base/docs/linux_deps.md)，macOS / iOS - [Xcode](https://developer.apple.com/xcode/resources/)，Android - [Android Studio](https://developer.android.com/studio)）以及 [git](https://git-scm.com/downloads)。*

```bash
git clone https://github.com/armory3d/armorpaint
cd armorpaint/paint
```

**Windows (x64)**
```bash
..\base\make
# 打开生成的 Visual Studio 工程 `build\ArmorPaint.sln`
# 编译并运行
```

**Linux (x64)**
```bash
../base/make --run
```

**macOS (arm64)**
```bash
../base/make
# 打开生成的 Xcode 工程 `build/ArmorPaint.xcodeproj`
# 编译并运行
```

**Android (arm64)**
```bash
../base/make --target android
# 打开生成的 Android Studio 工程 `build/ArmorPaint`
# 为设备编译
```

**iOS (arm64)**
```bash
../base/make --target ios
# 打开生成的 Xcode 工程 `build/ArmorPaint.xcodeproj`
# 为设备编译
```

**WASM**
```bash
../base/make --target wasm --compile --embed
```

**生成本地化语言文件**
```bash
./base/make --js base/tools/extract_locales.js <语言代码>
# 生成 `paint/assets/locale/<语言代码>.json` 文件
```

**内嵌数据文件**
```bash
# 需要支持 c23 #embed 的编译器（clang 19 或更新）
../base/make --embed
```