ios_rule_script/script/testflight/README.md

12 KiB
Raw Blame History

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

https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.sgmodule

Quantumult X

https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.snippet

Loon

https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.lnplugin

Stash

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

[Script]
TestFlight_自动加入 = type=cron,cronexp=0/5 * * * * *,script-path=https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.js

Quantumult X

[task_local]
0/5 * * * * * https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.js, tag=TestFlight_自动加入, enabled=true

Loon

[Script]
cron "0/5 * * * * *" script-path=https://raw.githubusercontent.com/blackmatrix7/ios_rule_script/master/script/testflight/testflight.js,timeout=5,TestFlight_自动加入

Stash

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非常重要务必记牢。

"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的数据格式如下

"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自动生成不需要配置