英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

Matchimals.fun

动物配对拼图卡牌游戏 🦁 🃏

🍎 从 App Store 下载 iOS 版本

🖥 在网页上桌面端游玩

怎么玩

1. 1-4 名玩家轮流将牌堆顶的牌与桌面上已有的牌连接。
2. 如果没有有效的连接可进行，则该玩家必须跳过。
3. 当牌堆中的所有牌都已在桌上连接完成时，游戏结束。

关于

Matchimals.fun 由 Chris Heninger（@chrisheninger）和 Hannah Heninger（@mshannahnv）作为概念验证开发。游戏玩法灵感来自 1959 年的一款叫 Busy Bee 的纸牌游戏。🐝 🃏

Matchimals.fun 适合各个年龄段的儿童。它旨在通过有趣的动物、颜色和数字视觉效果提供娱乐并提高模式识别能力。

该项目由 iGravity Studios 赞助——这是一家位于亚利桑那州菲尼克斯、专注于 UI/UX 开发的定制软件公司。🏜 ❤️

想要贡献吗？

这款游戏已开源，旨在帮助其他希望深入了解JavaScript、BoardGame.io 和React-Native应用的人。

发现了错误或有问题吗？随时可以打开一个问题或提交一个拉取请求！

发展

这是一个使用 连续原生生成 的 Expo 应用 —— ios/ 目录是从 app.json 生成的，并未提交。你需要安装 bun、Xcode 和 CocoaPods。

1. 分叉仓库
2. 安装依赖项：bun install
3. 在 iOS 模拟器中构建并运行应用：bun run ios
4. 或者运行网页版：bun run web

应用图标是由动物 SVG 渲染的：bun run generate:icons 会重新生成主图标、每个动物的替代图标（在 iOS 上可在设置中选择一个）以及网页图标 — 提交输出内容。

App Store 的截图和此 README 来自模拟器：bun run screenshots 会构建一个 Release 版本的应用，然后启动 iPhone 14 Plus（App Store Connect 要求的 6.5 英寸 iPhone 插槽，1284 × 2778 px）和 iPad Pro 13 英寸（13 英寸插槽，2064 × 2752 px），并且对于每种商店语言，在 iPhone 上进行两人游戏，在 iPad 上进行四人游戏 —— src/Matchimals/snapshots.ts 中的五个棋盘快照，随后是胜利卡片，使用 src/screenshots.ts 中的固定玩家，每个都通过 https://www.matchimals.fun/?screenshot=<state> 通用链接访问。编号的 PNG 图像会按上传顺序存放在 screenshots/<storefront>/<display>/（商店文件夹使用 App Store Connect 的区域代码，比如 store/metadata/）——提交它们；它们就是上传到 App Store Connect 的内容。添加 --skip-build 可重用上一次构建，或使用 --locales "en-US ja" 来选择部分语言。

字幕随后添加：bun run screenshots:caption 会将 store/captions/ 中的每套字幕（family、travel、no-ads — 显示 → 状态 → 商店铺面语言 → 文本，最多两行，在 Dimbo 中设置）叠加到那些截图上，将每条字幕放在主菜单的三角背景下（--frame card|bleed|slide|device 决定形式：贴纸卡、边缘对齐、顶部圆角幻灯片，或来自 store/frames/ 的真实设备图 — 默认 card 除非另有要求），并在相同的插槽尺寸下写入 screenshots-captioned/<set>/<storefront>/<display>/，将所用框架记录在 screenshots-captioned/<set>/frame.json 中，以确保一套字幕中不会混用两种框架 — 也要提交这些。bun run asc:listing --screenshots-dir screenshots-captioned/family 会将一套带字幕的截图放到主列表中（--dry-run 显示会发生的更改）；添加字幕需要 ImageMagick（brew install imagemagick）。

语言

该应用程序遵循设备语言：英语、西班牙语（西班牙和拉丁美洲）、巴西葡萄牙语、德语、法语、意大利语、日语、韩语和简体中文。所有面向用户的字符串都存放在 src/locales/<locale>.ts 中——英语是事实来源，并定义了 Translations 接口，因此任何语言缺少键都会导致类型错误——组件通过 t()、caps()（标题和按钮在渲染时根据语言规则大写）、playersLabel() 和 animalName() 从 src/i18n.ts 中读取它们。动物名称仅在渲染时翻译：英语的 AnimalName 在所有地方（状态、应用图标、截图链接）保持键不变。显示字体 Dimbo 仅包含拉丁字符，因此对于日语、韩语和中文，displayFont 会解析为平台字体（权重匹配）。

• bun run check:locales 在以下情况下会失败：缺失键、占位符不匹配、Dimbo 无法显示的字符或在固定宽度槽（以 Dimbo 测量）中溢出的字符串，并检查 store/metadata/ 是否符合 App Store Connect 的限制。
• bun run screenshots:locales 会在 iPhone 和 iPad 模拟器上拍摄每种语言的屏幕截图（主菜单、设置、名牌上最长的动物名称和胜利卡、游戏内菜单、动物选择器），保存到 build/locale-screenshots/ 文件夹，并为每种语言生成一张联系表。
• bun scripts/translations-review.mjs 会重新生成 store/translations-review.md，将每个字符串与其英语源并排，以供母语使用者审阅。

添加语言：复制 src/locales/en.ts，在 src/locales/index.ts 中注册它（如果裸语言应映射到它，则在 resolveLocale 的回退中也注册），将其添加到 app.json 的 CFBundleLocalizations，创建 store/metadata/<App Store locale>/，然后运行上述三个命令。每个应用商店列表（名称、副标题、关键词、促销文本、描述、更新说明）保存在 store/metadata/ 中，并手动粘贴到 App Store Connect。

部署到 TestFlight

iOS 版本完全在本地构建和上传（不需要 EAS 订阅或 fastlane）:

bun run deploy:ios

脚本 (scripts/deploy-ios.sh) 会自动递增 app.json 中的 ios.buildNumber（并提交该递增），运行 expo prebuild，使用 xcodebuild 打包归档，将构建直接上传到 App Store Connect，然后给提交打标签（ios-v<version>-<build>）并推送。除非你在干净的 main 分支上并且类型检查通过，否则它不会运行。如果上传步骤失败，修复原因后运行 bun run deploy:ios --upload-only 以重新上传已经构建的归档。版本号递增（expo.version）仍需手动操作 — 在发布新版本前编辑 app.json。

签名和上传会使用 Mac 上安装的 App Store Connect API 密钥进行认证：~/.private_keys/matchimals-asc.env 设置 ASC_KEY_ID 和 ASC_ISSUER_ID，密钥的 AuthKey_<id>.p8 放在旁边（ASC → 用户与访问 → 集成 → App Store Connect API；具有 App Manager 角色即可）。没有密钥时，会使用 Xcode 登录的 Apple ID（Xcode → 设置 → 账户）对应 app.json 中的团队 — 该会话会在几小时后失效，这通常是上传失败的原因。无论如何，Xcode 会创建所需的证书和配置文件。仓库中不存储任何机密。

当 main 分支推送时，网页版会通过 Netlify 自动部署（本地静态导出到 dist/ 可运行 bun run build:web）。

特别感谢

Nicolo Davis 和合作者们为回合制游戏引擎 boardgame.io 做出的贡献。

Facebook 和合作者们为出色的库 React 和 React-Native 做出的贡献。