Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fwh1990/react-native-upload
( MacOs ) 一键打包部署 android/ios APP到各个测试平台和App Store。ci/cd神器，拒绝繁琐
https://github.com/fwh1990/react-native-upload
react-native-appstore react-native-deploy react-native-fir react-native-pgy
Last synced: about 4 hours ago
JSON representation
( MacOs ) 一键打包部署 android/ios APP到各个测试平台和App Store。ci/cd神器，拒绝繁琐
- Host: GitHub
- URL: https://github.com/fwh1990/react-native-upload
- Owner: fwh1990
- License: mit
- Created: 2019-08-30T09:39:19.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2021-05-19T07:45:41.000Z (over 3 years ago)
- Last Synced: 2024-10-29T15:25:22.332Z (17 days ago)
- Topics: react-native-appstore, react-native-deploy, react-native-fir, react-native-pgy
- Language: Shell
- Homepage:
- Size: 137 KB
- Stars: 107
- Watchers: 3
- Forks: 22
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# react-native-upload
一键上传 android/ios APP到各个测试平台和`app store`
### 支持系统
**MacOs** (使用了`bash`语法，而且ios只能依赖xcode软件)
### 已集成平台
>- [蒲公英](https://www.pgyer.com) (android + ios)
>- [fir.im](https://betaqr.com) (android + ios)
>- [App Store](https://appstoreconnect.apple.com) (ios)
>- [Test Flight](https://developer.apple.com/testflight/) (ios)
# 安装
```bash
# Npm
npm install react-native-upload --save-dev
# Yarn
yarn add react-native-upload --dev
```
# 生成配置
先执行这个命令：
```bash
npx upload-init
```
执行命令后会在项目根目录中创建一个`upload.json`文件，并生成以下内容：
```json5
// 未用到的配置，可以置空不填写，也可以直接删除
{
// 上传到蒲公英
"pgy": {
// 上传凭证，访问链接 https://www.pgyer.com/account/api ，复制Api Key
"pgy_api_key": "",
// App安装方式，共有三种 1：公开，2：密码安装，3：邀请安装
"pgy_install_type": 1,
// App安装时的访问密码，选择 "2密码安装" 时，访问密码必填
"pgy_install_password": "",
"ios_export_plist": "./ios-export/ad-hoc.plist"
},
// 上传到fir.im
"fir": {
// 上传凭证，访问链接 https://betaqr.com/apps/apitoken ，复制token
"fir_api_token": "",
"ios_export_plist": "./ios-export/ad-hoc.plist"
},
// 上传到App Store
"app_store": {
###########################################################################
## 注意：user_* 与 api_* 是互斥的，只需要填写其中一组即可正常上传 ##
###########################################################################
// 用户（APPLE_ID）必须拥有该APP的上传权限
"user_name": "",
// 随机密码，访问链接 https://appleid.apple.com/account/manage ，点击 App专用密码 生成密码
"user_password": "",
// 秘钥ID，访问链接 https://appstoreconnect.apple.com/access/api ，点击蓝色圆形+号图标即可生成秘钥。
##########################################################################
## 注意：生成秘钥后，必须下载秘钥文件，并复制到以下随意一个文件夹中： ##
## ./private_keys ##
## ~/private_keys ##
## ~/.private_keys ##
## ~/.appstoreconnect/private_keys ##
##########################################################################
"api_key": "",
// 生成秘钥后，秘钥的列表上方有个 Issuer ID
"api_issuer": "",
"ios_export_plist": "./ios-export/app-store.plist"
},
// 上传到Test Flight
// 默认从app_store配置中拿 user_* 或者 api_*，也可以在test_flight配置下覆盖这几个参数
"test_flight": {
"ios_export_plist": "./ios-export/ad-hoc.plist"
}
}
```
# 准备工作
`ios_export_plist`即ios打包参数的存放路径。因为ios的打包参数十分复杂，每个项目都会有一些差异，所以为了保证能准确无误地打包出符合要求的app，您需要手动执行一次以下内容（**只需一次**）。
### 1、手动打包
点击 `Xcode -> Product -> Archive`，等待打包完成
### 2、导出app
点击 `Xcode -> Window -> Organizer`，选择刚才打的包，点击右边按钮`Distribute App`，进行一系列选择之后，最后点击`Export`按钮，把文件下载到本地磁盘。
一般来说，您可能需要手动导出两份app文件：
>- 如果您想把app上传到测试平台，请尽量选择`Ad Hoc`的打包方式
>- 如果您想把app上传到App Store，请选择`ios App Store`的打包方式
### 3、复制plist文件
导出的app目录中大致包含如下内容：
请将文件`ExportOptionns.plist`复制到项目中，并保持与配置`ios_export_plist`所指向的路径一致。推荐您将文件重命名为打包方式的名称，如`ad-hoc.plist`、`app-store.plist`等。
# 自动打包上传
### 蒲公英
```bash
npx upload-pgy
# 填写更新日志
npx upload-pgy --log "增加xxx功能"
# 忽略平台
npx upload-pgy --no-android
npx upload-pgy --no-ios
# android默认打包release版本，可以改成debug版本
npx upload-pgy --variant=debug
# 多渠道打包时，默认上传所有生成的android apk文件，可以使用正则表达式指定文件名称
npx upload-pgy --apk=app-release.apk
npx upload-pgy --apk=x86_64
npx upload-pgy --apk=release-[0-9]
```
### fir.im
```bash
npx upload-fir
# 填写更新日志
npx upload-fir --log "增加xxx功能"
# 忽略平台
npx upload-fir --no-android
npx upload-fir --no-ios
# android默认打包release版本，可以改成debug版本
npx upload-fir --variant=debug
# 多渠道打包时，默认上传所有生成的android apk文件，可以使用正则表达式指定文件名称
npx upload-fir --apk=app-release.apk
npx upload-fir --apk=x86_64
npx upload-fir --apk=release-[0-9]
```
### App Store
```bash
npx upload-appstore
# 或者缩写
npx upload-as
```
### Test Flight
```bash
npx upload-testflight
# 或者缩写
npx upload-tf
```
# 只打包不上传
由于某种原因，您只想安安静静地打包出app而不上传到任何平台，您可以用以下指令处理您的需求：
```bash
# 同时打包android和ios
npx upload-build --ios-export-plist path/to/xxx.plist
# 安卓默认打包release版本，可以改成debug版本
npx upload-build --ios-export-plist path/to/xxx.plist --variant=debug
# 单独打包android
npx upload-build --no-ios
# 单独打包ios
npx upload-build --no-android --ios-export-plist path/to/xxx.plist
```
------
欢迎使用并给我提建议，有任何通用平台需要集成也可以cue我