mirror of
https://github.com/blackmatrix7/ios_rule_script.git
synced 2024-12-26 09:09:26 +08:00
285 lines
12 KiB
Markdown
285 lines
12 KiB
Markdown
# TestFlight
|
||
|
||
## 前言
|
||
|
||
TestFlight多账户共存与自动加入脚本，主要满足个人需要两个脚本共存的需求。
|
||
|
||
**感谢NobyDa、DecoAri、chouchoui、lodepuly等大佬的源代码。**
|
||
|
||
本脚本部分参考了上述大佬的脚本源代码。
|
||
|
||
相对于原版，做了以下改动：
|
||
|
||
**TestFlight 自动加入**
|
||
|
||
1. 支持NodeJS，含青龙面板
|
||
2. 支持多账户
|
||
3. 支持MITM Over HTTP/1.1 与 HTTP/2
|
||
4. 支持控制加入TF的并发数量
|
||
5. 支持Session失效检测
|
||
6. 支持满员的TF自动加入任务
|
||
7. 支持温和、标准和暴力三种加入模式
|
||
8. 标准模式下，支持指定账号检测TF可否加入
|
||
|
||
**TestFlight 多账户共存**
|
||
|
||
1. 支持多账户同步
|
||
2. 去除共享功能
|
||
3. 保留当前账户“以前测试过”的列表
|
||
|
||
## 部署
|
||
|
||
**Surge**
|
||
|
||
```ini
|
||
https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.sgmodule
|
||
```
|
||
|
||
**Quantumult X**
|
||
|
||
```ini
|
||
https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.snippet
|
||
```
|
||
|
||
**Loon**
|
||
|
||
```ini
|
||
https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.lnplugin
|
||
```
|
||
|
||
**Stash**
|
||
|
||
```ini
|
||
https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.stoverride
|
||
```
|
||
|
||
## 入门
|
||
|
||
安装对应的模块/重写/插件/覆写
|
||
|
||
### **TestFlight 多账户共存**
|
||
|
||
在AppStore中切换不同的账号，每切换一个账号需要重新打开TestFlight，直至弹出获取必要信息成功的通知。
|
||
|
||
随后即可在TestFlight App中查看所有共存账号的App。
|
||
|
||
### **TestFlight 自动加入**
|
||
|
||
在AppStore中登录需要加入TestFlight的账号，打开TestFlight，弹出获取必要信息成功的通知。
|
||
|
||
打开需要加入的TestFlight App链接，如果已满员会自动加入任务列表。
|
||
|
||
脚本主要运行平台为青龙面板，所以在默认的配置中不带有计划任务。需要根据运行平台不同，手动为脚本设置一个定时任务。
|
||
|
||
#### **Surge**
|
||
|
||
```ini
|
||
[Script]
|
||
TestFlight_自动加入 = type=cron,cronexp=0/5 * * * * *,script-path=https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.js
|
||
```
|
||
|
||
#### **Quantumult X**
|
||
|
||
```ini
|
||
[task_local]
|
||
0/5 * * * * * https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.js, tag=TestFlight_自动加入, enabled=true
|
||
```
|
||
|
||
#### **Loon**
|
||
|
||
```ini
|
||
[Script]
|
||
cron "0/5 * * * * *" script-path=https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.js,timeout=5,TestFlight_自动加入
|
||
```
|
||
|
||
#### **Stash**
|
||
|
||
```yaml
|
||
cron:
|
||
script:
|
||
- name: testflight.js
|
||
cron: '0/5 * * * * *'
|
||
argument: ''
|
||
timeout: 10
|
||
```
|
||
|
||
#### **青龙面板**
|
||
|
||
在Web界面中，选择“定时任务”，选择新增，定时规则为“*/5 * * * * *”，即5秒运行一次。
|
||
|
||
### **大功告成**
|
||
|
||
如果你不想太过折腾，那么到这来配置就结束了，不需要再往下阅读。
|
||
|
||
## 进阶
|
||
|
||
### TestFlight 多账户共存
|
||
|
||
#### 多设备互相同步
|
||
|
||
脚本支持通过青龙面板，将多账户共存的信息在不同设备、不同客户端间互相同步。
|
||
|
||
举个例子，你有几台iPhone、iPad，它们使用不同的客户端，但是都使用同个脚本，连接同个青龙面板。那么当开启“同步数据到青龙面板”时，TestFlight的账户数据会在多个设备间互相同步。
|
||
|
||
更具体地说，你在iPhone上，登录A、B两个账号；在iPad上，登录C、D两个账号。开启同步后，你的iPhone、iPad和青龙面板将同时存储A、B、C、D四个账号的信息。这样无论你打开哪台设备的TestFlight的App，它们的数据是完全一致的。
|
||
|
||
当然，你也可以一台iPhone登录国区账号，一台iPhone登录外区账号，两台间互相同步。
|
||
|
||
**特别说明**
|
||
|
||
1. 数据同步可能会影响TestFlight的加载速度，建议只在必要时开启。
|
||
2. 如果多设备间数据冲突时，以青龙面板中存储的数据为准。
|
||
3. 如果需要删除某个账号，需要在青龙面板的magic.json文件中删除，在iOS设备中删除无效，下次还会从青龙面板同步回来。
|
||
|
||
### TestFlight 自动加入
|
||
|
||
#### 手动编辑需要加入的AppId
|
||
|
||
通过`tf_app_id`变量来存储需要加入的AppId，以;分隔。你可以在BoxJS，或magic.json文件中编辑它。
|
||
|
||
**需要注意原版是以,分隔，此处配置不同。**
|
||
|
||
#### 同步至青龙面板
|
||
|
||
https://github.com/blackmatrix7/ios_rule_script/tree/master/script#readme
|
||
|
||
根据上述文档，配置青龙面板，然后在BoxJS中打开同步至青龙面板的开关。配置完成后，每次打开TestFlight，登录信息变化时都会同步到青龙面板中。同时，在打开已满员的Beta链接时，也会将App ID同步至青龙面板。
|
||
|
||
**特别说明**
|
||
|
||
1. TestFlight中的App ID与青龙面板的同步是单向的，只能从设备同步到青龙面板。
|
||
2. 青龙面板最终存储的App ID为所有设备同步数据的合集。
|
||
|
||
#### 并发数量
|
||
|
||
指当App的Beta为可加入状态时，**每个账户**并发多少个请求来尝试加入。默认为2个，并发数量并不是越高越好。
|
||
|
||
#### 三种模式的区别
|
||
|
||
#### 温和
|
||
|
||
查询App的Beta状态时，不携带用户信息，仅在App可加入时才会使用存储的用户信息发起申请，理论上可以极大减少AppleID被Ban的几率。缺点为ResponeBody较大，查询的速度相较标准模式可能会稍慢。
|
||
|
||
**此模式未经验证。**
|
||
|
||
#### 标准
|
||
|
||
默认采用标准模式。
|
||
|
||
同原版一致的逻辑，查询App的Beta状态时，会带入一个用户的信息进行查询。在App可加入时，使用存储的用户信息发起申请。缺点是每次查询都会携带用户信息，理论上有导致AppleID被Ban的风险，不过目前并无先例。
|
||
|
||
**你可以指定一个小号专门用于检测可用性，具体见后文。**
|
||
|
||
#### 暴力
|
||
|
||
不查询App的Beta状态，直接使用存储的用户信息申请加入，如果无法加入会引发409的异常。优点是没有查询过程，抢App的Beta测试员成功率可能会更高。缺点是会持续不断的产生异常的请求，理论上被Ban的风险最大。
|
||
|
||
**此模式未经过验证。慎选，建议使用新注册的账号试验。**
|
||
|
||
#### 多账户自动加入
|
||
|
||
可以通过在iOS的设置中，切换AppStore账户，再打开TestFlight App来实现多账户加入。
|
||
|
||
多账户并不能提高加入的成功率，相反因为需要尝试加入的账户数量变多，反而会降低成功率。
|
||
|
||
多账户存储的数据格式如下，其中类似"xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"为AccountId，非常重要，务必记牢。
|
||
|
||
```json
|
||
"tf_session_info": {
|
||
"magic_session": true,
|
||
"xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx": {
|
||
"X-Session-Id": "xxxxxxxxxxxxxxxx",
|
||
"X-Session-Digest": "xxxxxxxxxxxxxx",
|
||
"X-Request-Id": "xxxxxxxxxxxxx"
|
||
},
|
||
"xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxoo": {
|
||
"X-Session-Id": "xxxxxxxxxxxxx",
|
||
"X-Session-Digest": "xxxxxxxxxxxxxx",
|
||
"X-Request-Id": "xxxxxxxxxxxxx"
|
||
}
|
||
}
|
||
```
|
||
|
||
**不同账户加入不同的App Beta测试员**
|
||
|
||
脚本通过`tf_joined_app_id`存储的数据来判断哪些账户需要加入哪些AppID。
|
||
|
||
tf_joined_app_id的数据格式如下：
|
||
|
||
```json
|
||
"tf_joined_app_id": {
|
||
"magic_session": true,
|
||
"xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx": [
|
||
"*",
|
||
"PTbaSXrf",
|
||
"J3awzdqd",
|
||
"aL5ZWE8A",
|
||
"iSTXkF4K"
|
||
],
|
||
"xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxoo": [
|
||
"*"
|
||
]
|
||
}
|
||
```
|
||
|
||
magic_session 不可修改和删除，xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx为你的账户AccountId，对应的数组则是已经加入成功的AppId。
|
||
|
||
假设不想让AccountId为xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx的账户加入PTbaSXrf的测试，在对应的数组中写入AppId即可。此时如果存在其他账户，则其他账户依旧会尝试加入PTbaSXrf的测试，直至成功。
|
||
|
||
如果某个账户，不希望它加入任何TF，则给它加一个"*"，表示任何APP的测试都不加入。
|
||
|
||
#### 专用账户检查TF
|
||
|
||
在标准模式下，可以指定一个账号专门用于检查App的TestFlight是否可加入。在BoxJS或magic.json中，为`tf_check_account_id`这个变量分配一个account id，将这个账户用来检查App的Beta成员是否已满。只有当Beta可加入时，才会用真正的账户来尝试加入，以达到保护主账号的目的。
|
||
|
||
举个例子，你可以注册一个新的账号，专门用于检查TF可否加入，当可以加入时，再用你的主账号尝试加入。
|
||
|
||
需要注意的是以下几点:
|
||
|
||
1. 专门用于检查的账号也需要获取Session，同时这个账号也会尝试加入TF，除非你根据上一条的`tf_joined_app_id`配置，排除掉。
|
||
2. 不用于检查的主账号，最好隔段时间就刷新一下Session，以免会话过期。
|
||
|
||
#### 连续运行
|
||
|
||
配置`tf_loop_count`来设置脚本每次启动时，执行多少次任务再退出，每次任务间隔固定800毫秒。通过配置连续运行次数，可以减少青龙面板的脚本执行频次，避免因为日志过多导致青龙面板没有响应。
|
||
|
||
如果是NodeJS环境(非青龙面板)，可以设置为0，脚本将持续运行不会终止。
|
||
|
||
不要在手机上将`tf_loop_count`设置为0，否则脚本会一直运行直到超时，或被手动中止。
|
||
|
||
#### Session检测
|
||
|
||
因为脚本的主要运行环境是青龙面板，所以可能存在Session因为长期未更新导致失效的情况。为此加入每2小时检测一次Session有效期的功能，如果失效会推送通知到手机，需要再手动获取信息，并同步到青龙面板。
|
||
|
||
检测间隔可以通过变量`tf_check_session_time_diff`配置，单位秒，不要配置过短，以免影响脚本正常功能。
|
||
|
||
## 其他
|
||
|
||
如果有问题欢迎反馈。
|
||
|
||
### Loon暂不支持MITM Over HTTP/2
|
||
|
||
已经和作者反馈，需要等待Loon更新。
|
||
|
||
### Shadowrocket未经验证
|
||
|
||
Shadowrocket未经验证，不确保能够正常使用
|
||
|
||
## 脚本变量
|
||
|
||
当前脚本使用的变量，你可以根据这些Key，在magic.json中配置数据。
|
||
|
||
| 名称 | 类型 | 默认值 | 说明 |
|
||
| -------------------------- | ------ | ------ | ------------------------------------------------------------ |
|
||
| tf_session_info | Json | 无 | 由脚本自动获取的Session信息，如需修改请整个删除重新获取 |
|
||
| tf_app_id | String | 无 | 需要加入Beta的AppId，多个以;分隔 |
|
||
| tf_join_mode | Int | 1 | 执行默认 0 温和 1 标准 2 暴力 |
|
||
| tf_join_concurrency | Int | 2 | 每个账户并发加入TestFlight Beta测试员的请求数 |
|
||
| tf_joined_app_id | Json | 无 | 存储每个账户已经成功加入的AppId |
|
||
| tf_check_account_id | String | 无 | 专门用于检查TF可用性的Id，如果为空则从已登录的账户中随机选择 |
|
||
| tf_loop_count | Int | 1 | 每次运行脚本时循环多少次，每次循环间隔800毫秒，NodeJS(非青龙面板)可设置为0，表示持续运行 |
|
||
| tf_check_session_time_diff | Int | 7200 | 每间隔多少秒检查一次账户的有效性，默认7200秒 |
|
||
| tf_check_session_time | Int | 无 | 上次检查账户有效期的时间，自动生成，不需要配置 |
|
||
| tf_invalid_app_id | Json | 无 | 验证无效的AppId，自动生成，不需要配置 |
|
||
|