构建与部署 (Build & Deploy)

从 C 源码到 pokeemerald.com——pokeemerald-wasm 的构建系统将 280+ 个 C 文件编译为单一 WebAssembly 模块，打包静态资源，部署到 Cloudflare Workers 的全球边缘网络。整个过程通过 Makefile 目标串联，一条 make wrangler-site 命令即可完成全部构建和打包。

涵盖内容

章节	核心主题
构建概念	部署管线、Makefile 目标、Cloudflare Workers 配置
练习	构建目标分析、部署配置修改、CI/CD 设计
代码走读	Makefile / server.mjs / build_wrangler_site.mjs 逐行解读

核心概念

pokeemerald-wasm 的构建部署系统分为两个阶段：

• 构建阶段：make wasm 使用 Clang 将 C 源码编译为 .wasm 模块，make wasm-assets 生成游戏资源文件，最终链接为单一 pokeemerald.wasm
• 部署阶段：make wrangler-site 将 WASM 模块和前端文件打包到 dist/cloudflare/ 目录，通过 wrangler CLI 部署到 Cloudflare Workers

关键文件：

• Makefile：定义 wasm、serve-wasm、wrangler-site 等构建目标
• wrangler.toml：Cloudflare Workers 配置（路由、域名、构建命令）
• web/server.mjs：本地开发服务器（Node.js http 模块）
• tools/build_wrangler_site.mjs：打包脚本，将构建产物复制到 dist 目录

前置知识

知识点	说明
Makefile 基础	理解目标、依赖、命令的编写规则
[[topics/wasm-compilation/index	WASM 编译管线]]
CI/CD 基本概念	了解持续集成/部署的流程
Cloudflare Workers 基础	了解 Workers 的静态资源托管模式（可选）

学习路径

→ 下一步：源码兼容与适配