ArmorCore 安装与配置指南

一、项目基础介绍

ArmorCore 是一个开源的 3D 引擎核心，使用 C 语言开发，并支持 JavaScript 脚本。它旨在支持多种图形 API，包括 Direct3D12、Vulkan、Metal 和 WebGPU。ArmorCore 利用 Kinc 作为底层硬件抽象库，为开发者提供了一个跨平台的高性能图形渲染解决方案。

主要编程语言：C、JavaScript

二、项目使用的关键技术和框架

• Kinc：一个低级别的硬件抽象库，用于简化不同图形 API 的使用。
• V8：Google 开发的一个开源 JavaScript 引擎，用于在 C 代码中嵌入 JavaScript 脚本支持。
• Direct3D12、Vulkan、Metal、WebGPU：支持的主流图形 API，用于在不同平台上实现高性能的图形渲染。

三、项目安装和配置的准备工作

在开始安装 ArmorCore 之前，请确保您的开发环境满足以下要求：

1. 操作系统：支持 Windows、Linux 或 macOS。
2. 编译器：对于 Windows 用户，需要安装 Visual Studio；对于 macOS 用户，需要安装 Xcode；对于 Linux 用户，需要安装相应的编译工具和依赖库。
3. 依赖库：确保已安装 CMake 以及其他可能需要的依赖库。

四、详细的安装步骤

以下是在不同操作系统上安装 ArmorCore 的详细步骤：

Windows (x64)

1. 克隆项目仓库：

   git clone https://github.com/armory3d/armorcore.git
   cd armorcore
   

2. 构建项目：

   ./make --graphics direct3d12
   

3. 打开生成的 Visual Studio 项目：

   # 打开 build\Armory.sln 文件
   

4. 编译并生成可执行文件：

   使用 Visual Studio 打开项目并编译，确保选择 x64 和 Release 配置。

Linux (x64)

1. 克隆项目仓库：

   git clone https://github.com/armory3d/armorcore.git
   cd armorcore
   

2. 构建项目：

   ./make --graphics vulkan --compile
   

3. 编译并生成可执行文件：

   使用您的系统编译器进行编译。

macOS (arm64)

1. 克隆项目仓库：

   git clone https://github.com/armory3d/armorcore.git
   cd armorcore
   

2. 构建项目：

   ./make --graphics metal
   

3. 打开生成的 Xcode 项目：

   # 打开 build/Armory.xcodeproj 文件
   

4. 编译并生成可执行文件：

   使用 Xcode 打开项目并编译。

Android (arm64)

1. 克隆项目仓库：

   git clone https://github.com/armory3d/armorcore.git
   cd armorcore
   

2. 构建项目：

   ./make --graphics vulkan --target android
   

3. 打开生成的 Android Studio 项目：

   # 打开 build/Armory 文件夹
   

4. 编译并生成 APK 文件：

   使用 Android Studio 打开项目并编译。

iOS (arm64)

1. 克隆项目仓库：

   git clone https://github.com/armory3d/armorcore.git
   cd armorcore
   

2. 构建项目：

   ./make --graphics metal --target ios
   

3. 打开生成的 Xcode 项目：

   # 打开 build/Armory.xcodeproj 文件
   

4. 编译并生成可执行文件：

   使用 Xcode 打开项目并编译。

WebAssembly (wasm)

1. 克隆项目仓库：

   git clone https://github.com/armory3d/armorcore.git
   cd armorcore
   

2. 构建项目：

   ./make --graphics webgpu --target wasm
   

3. 编译并生成 WebAssembly 模块：

   根据您的构建系统进行编译。

以上步骤将帮助您在不同的平台上成功安装和配置 ArmorCore 项目。请根据您的具体需求选择合适的平台进行操作。