Bangumi 追番记录 App 发布流程指南:3 步完成 Android 与 iOS 双端打包上架-港品优选

Bangumi 追番记录 App 发布流程指南:3 步完成 Android 与 iOS 双端打包上架

【免费下载链接】Bangumi:electron: An unofficial https://bgm.tv ui first app client for Android and iOS, built with React Native. 一个无广告、以爱好为驱动、不以盈利为目的、专门做 ACG 的类似豆瓣的追番记录，bgm.tv 第三方客户端。为移动端重新设计，内置大量加强的网页端难以实现的功能，且提供了相当的自定义选项。目前已适配 iOS / Android。项目地址: https://gitcode.com/GitHub_Trending/ba/Bangumi

Bangumi 番组计划是一款无广告、以爱好驱动的 bgm.tv 第三方客户端,专门做 ACG 追番记录,支持 iOS 与 Android 双端,用 React Native 开发(一套代码同时构建两个平台的 App)。本文带你从一份源码出发,依次完成本地跑通、Android 打包、iOS 打包三件事,最终得到可分发、可上架的安装包。适合第一次接触 React Native 发布流程的新手,以及想了解这个 App 是怎么产出的普通用户。

准备清单:动手前需要哪些环境与资料

先确认手里的工具齐全,避免执行到一半才发现缺东西。

需要准备	用途	平台
Node.js 与 yarn	安装依赖、执行所有构建脚本	通用
git	拉取源码	通用
Android SDK 与 JDK	编译 APK 安装包	Android 打包
Xcode 与 Apple 开发者证书	签名并构建 IPA 安装包	iOS 打包

Android 侧注意:项目已脱离 Expo 托管环境,属于 bare workflow(自己管理原生工程),打包前请先阅读 android/README.MD
iOS 侧注意:需要一台 macOS 机器,证书与描述文件在苹果开发者后台申请

第 1 步:拉取源码并跑通本地开发环境

这一节的目标是先在真机上看到 App 跑起来,确认环境没问题。

用git clone https://gitcode.com/GitHub_Trending/ba/Bangumi获取源码
安装依赖。项目启用了 patch-package,依赖装完后会自动把 patches/ 里的第三方库补丁打上去,这是它能正常运行的前提之一
手机用 USB 连接并允许调试,执行yarn dev会自动编译并推送到手机
执行到这一步时,只要启动画面正常显示、能进入首页,就说明环境通过了

第 2 步:配置签名,一条命令产出 Android 发布包

📌 这一步做一件事:让打出来的 APK 能被用户安装、以后还能发更新版本。

先生成自己的签名文件my-release-key.keystore,放到android/app/目录
把android/gradle_yours.properties复制改名为gradle.properties,填入签名密码;必要时再手动创建local.properties指向你的 SDK 目录
然后执行yarn build即可打包,完成后用yarn open直达 APK 输出目录
若 Android 与 iOS 的依赖有差异,先按 android/README.MD 的说法,用packages/android/下的 package.json 替换根目录那份再装依赖

第 3 步:打包 iOS 并核对商店资料

这一节把 iOS 的 IPA 产出来,顺便把上架需要的素材核对一遍。

在 Xcode 里用 Release 配置构建 IPA,项目里提供了现成脚本 web/ipa.js,对应yarn make:ipa一键完成
依赖管理在 ios/Podfile,原生工程是ios/Bangumi.xcworkspace,别用错入口
上架素材核对清单:
- 应用图标与启动图在 ios/Bangumi/Images.xcassets/,图标需符合苹果各尺寸规范
- 商店里的中英文描述文案已预置在 fastlane/metadata/ 下,改好直接可用

进阶:发布后的提速技巧

🔑 做完上面三步后,还可以这样让后续发布更省力。

JS 更新免审推送:项目在eas.json里配好了 development / preview / production 三档渠道,执行yarn pub就能把纯 JS 层改动推送到线上,不必每次都等商店审核
版本号统一管理:版本信息集中在app.json的version与versionCode字段,发版时只改这一处
自动化提交商店:fastlane 是苹果与谷歌商店的官方自动化工具链,描述文案既然已经按它的目录结构放好了,接入 fastlane 提交审核就是顺手的事

常见坑与排查

Metro 调试进程起不来→ 多为 JDK 版本或子依赖小版本变动导致 → 按 android/README.MD 的说明调整环境,或单开yarn metro只起调试进程
Android 打包签名报错→ keystore 没放对位置,或gradle.properties里密码没填 → 对照第 2 步逐项核对四个签名配置项
iOS 提示版本号不匹配→ git tag 描述的版本与 app.json 实际构建版本不一致 → 同步两边版本号后重新打包
手机添加源时连接超时→ 手机访问外网不畅 → 检查网络,确保 AltServer 已信任该设备

收尾:下一步可以做什么

到这里,你已经走完「代码 → 本地运行 → Android APK → iOS IPA」的完整链路:一份源码,两个平台的安装包,商店文案也是现成的。这套流程的价值在于可重复——以后每个新版本的发布都是同样几步,熟练之后一次打包不到半天。下一步建议:把 IPA 通过 AltStore 装到自己手机上真实用一周,收集崩溃与体验问题,再考虑接入 CI 让构建全自动跑起来。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析