pokeemmo/docs/install/mac/MAC_OS_ZH.md

macOS 编译指南

1. 如果未安装 Xcode 命令行工具，请点击此处下载工具，打开终端并运行以下命令：

   xcode-select --install
   

2. • 如果 未安装 libpng，请跳转到 [安装 libpng (macOS)](# 安装 libpng (macOS))
   • 如果 未安装 pkg-config，请跳转到 [安装 pkg-config (macOS)](#安装 pkg-config (macOS))
   • 如果 未安装 devkitARM，请跳转到 [安装 devkitARM (macOS)](#安装 devkitARM (macOS))
   • 如果以上都已安装，请打开终端并跳转到 选择 pokeemerald-expansion 存储位置 (macOS)

3. 可选：运行测试
   如果未安装 Homebrew 环境，请参考此指南安装包管理器。打开终端运行：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   brew install coreutils
   

4. 可选：通过 Rosetta 运行测试

   • 通常不建议这样做（速度较慢）。多数用户可使用原生工具，但某些情况（如使用仅支持 Intel 的自定义工具链）可能需要此配置
   • 需安装 Intel 兼容的 Homebrew，配置方法参考此说明
   • 使用 Intel 兼容的 Homebrew 安装 coreutils（步骤同第 3 步）

安装 libpng (macOS)

高级用户注意...

本指南通过 Homebrew 安装 libpng（最简单方法），高级用户可通过其他方式自行安装

1. 打开终端

2. 如未安装 Homebrew，请按官网说明安装 Homebrew

3. 运行以下命令安装 libpng：

   brew install libpng
   

   libpng 现已安装完成

   如果 未安装 pkg-config 请跳转至 [安装 pkg-config (macOS)](#安装 libpng (macOS))；如果 未安装 devkitARM 请跳转至 [安装 devkitARM (macOS)](#安装 devkitARM (macOS))

   若两者均已安装，请前往 选择 pokeemerald-expansion 存储位置 (macOS)

安装 pkg-config (macOS)

高级用户注意...

本指南通过 Homebrew 安装 pkg-config（最简单方法），高级用户可通过其他方式自行安装

1. 打开终端

2. 如未安装 Homebrew，请按官网说明安装 Homebrew

3. 运行以下命令安装：

   brew install pkg-config
   

   pkg-config 现已安装完成

   如果 未安装 devkitARM 请跳转至 [安装 devkitARM (macOS)](#安装 devkitARM (macOS))，否则前往 选择 pokeemerald-expansion 存储位置 (macOS)

安装 devkitARM (macOS)

1. 从此链接下载 devkitpro-pacman-installer.pkg 安装包

2. 打开安装包完成 devkitPro pacman 的安装

3. 在终端运行以下命令安装 devkitARM：

   sudo dkp-pacman -Sy
   sudo dkp-pacman -S gba-dev
   sudo dkp-pacman -S devkitarm-rules
   

   gba-dev 安装时会提示选择软件包，直接按 Enter 键安装全部，然后输入 Y 确认安装

4. 安装完成后，需让系统全局访问 devkitARM。运行以下命令：

   export DEVKITPRO=/opt/devkitpro
   echo "export DEVKITPRO=$DEVKITPRO" >> ~/.zshrc
   export DEVKITARM=$DEVKITPRO/devkitARM
   echo "export DEVKITARM=$DEVKITARM" >> ~/.zshrc
   echo "if [ -f ~/.zshrc ]; then . ~/.zshrc; fi" >> ~/.zprofile
   

   注：从 macOS 10.15 开始默认使用 zsh 终端。若从旧版本迁移，可能仍在使用 bash，可通过终端运行 echo $0 确认

   如果终端使用 bash 而非 zsh...

   export DEVKITPRO=/opt/devkitpro
   echo "export DEVKITPRO=$DEVKITPRO" >> ~/.bashrc
   export DEVKITARM=$DEVKITPRO/devkitARM
   echo "export DEVKITARM=$DEVKITARM" >> ~/.bashrc
   echo "if [ -f ~/.bashrc ]; then . ~/.bashrc; fi" >> ~/.bash_profile
   

安装 Python (macOS)

1. 从官网下载最新版 Python 安装包
2. 打开安装包完成安装

Python 现已安装完成