Mobile App Automizer快速上手教程：从安装到生成配置文件只需10分钟-平芜编程栈

Mobile App Automizer快速上手教程：从安装到生成配置文件只需10分钟

【免费下载链接】mobile-app-automizerYou can automize iOS and Android app's build, upload and versioning processes via Mobile App Automizer CLI tool.项目地址: https://gitcode.com/gh_mirrors/mo/mobile-app-automizer

Mobile App Automizer是一款移动端应用自动化工具，它通过一条命令行（CLI）指令，就能自动完成 iOS 和 Android 应用的构建、上传和版本号管理全流程。无论你的项目是原生开发，还是基于 React Native、Flutter 构建，都可以把应用一键发布到 Apple App Store、Google Play 或你自己的 CDN，彻底告别繁琐的重复操作。

⏱️ 本文适合新手：跟着步骤走，10 分钟内即可完成安装并生成配置文件。

一、为什么需要移动端自动化构建工具？

手动发布移动端应用时，你通常需要反复执行这些操作：

📦 切换 Scheme、配置环境（production / stage）
🚀 执行构建命令并等待打包完成
📤 手动上传到 App Store、Google Play 或 CDN
🔢 手动修改版本号并更新package.json

Mobile App Automizer 把上述步骤压缩成一条命令。你在安装时回答几个简单问题，工具就会自动生成配置文件，之后每次发布只需运行mobile-app-automizer即可，构建、上传、版本号升级一气呵成。

二、一键安装：3 个步骤完成部署

步骤 1：安装 Node.js

Mobile App Automizer 基于 Node.js 开发，因此需要先在电脑上安装 Node.js（任意较新版本即可）。

步骤 2：全局安装 CLI 工具

打开终端，执行以下命令：

npm install -g mobile-app-automizer

安装完成后，mobile-app-automizer命令就会出现在你的终端中。

步骤 3：进入你的移动端项目目录

切换到包含你移动端应用的仓库目录，后续所有操作都在这里进行。

三、最快生成配置文件的方法：交互式向导

在项目目录下运行安装命令，工具会启动一个交互式问答向导：

mobile-app-automizer --install

向导会依次询问你 13 个简单问题，包括：

问题	说明
是否构建 iOS 应用	选择 Yes 后继续配置
iOS 生产/测试环境 Scheme	填入 Xcode 中的 Scheme 名称
是否使用 Firebase	仅 iOS 项目需要
iOS 上传方式与账号	App Store 或 CDN，需 Apple 用户名、应用专用密码、Team ID、Bundle ID
是否构建 Android 应用	选择 Yes 后配置上传方式
是否启用版本号管理	建议开启，自动升级版本号

回答完成后，工具会自动在项目根目录生成配置文件.ma-automizer.js（配置模板来自 templates/config.js），如果选择 iOS 上传，还会额外生成ios/exportOptions.plist。

💡重要提示：请记得把.ma-automizer.js提交到代码仓库，避免丢失你的个性化配置。之后想修改任何选项，直接编辑该文件即可。

四、一条命令完成构建、上传与版本管理

配置完成后，真正的"魔法时刻"来了——只需运行：

mobile-app-automizer

工具便会自动按顺序执行：构建 → 上传 → 版本号升级。默认环境下是production环境，版本号按patch级别递增。

常用参数速查表

参数	作用	示例
`--stage`	使用测试（stage）环境构建，会跳过版本号升级	`mobile-app-automizer --stage`
`--verbose`	显示后台详细执行日志，便于排查问题	`mobile-app-automizer --verbose`
`--minor`	版本号次级升级（如 1.2.0 → 1.3.0）	`mobile-app-automizer --minor`
`--major`	版本号主级升级（如 1.2.0 → 2.0.0）	`mobile-app-automizer --major`
`--clean`	清理 iOS / Android 构建产物	`mobile-app-automizer --clean --ios`

📌 版本号管理遵循语义化版本（semantic versioning）规范，仅对 production 环境生效，且项目根目录需要存在package.json文件。

五、支持哪些上传目标？

📱Apple App Store（TestFlight）：在 Apple ID 账号页面创建一个"应用专用密码"，向导中填入即可。工具会自动为你生成并维护exportOptions.plist文件。

🤖Google Play Store：需要项目中已配置gradle-play-publisher，之后即可自动化上传。

☁️自建 CDN：上传到自己的 CDN 时，记得更新.ma-automizer.js中 upload 部分的函数和值。工具会自动为 iOS 应用生成manifest.plist和exportOptions.plist文件（模板分别位于 templates/manifest.js 和 templates/exportOptions.js）。