# appforshare 中文文档

规范地址：https://npmcn.com/package/appforshare/

版本：1\.10\.1
npm 元数据更新时间：2026-11-03T01:24:03.274Z
中文译文更新时间：2026-11-03T03:44:59.675Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/appforshare
原文对照：https://npmcn.com/package/appforshare/?lang=original
项目主页：https://appforshare.io/docs/ci

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：45.5 kB，3 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-10-31T02:52:03.221Z
- 最新版本发布：2026-11-03T01:24:03.104Z
- 已发布版本数：13（近 12 个月 13 个）

## 中文简介

从终端或CI上传iOS和Android版本到AppForShare，并获得安装链接。

## 安装

```sh
npm install appforshare
```

也可以使用：`pnpm add appforshare`、`yarn add appforshare`、`bun add appforshare`

## README

# appforshare

上传iOS （.ipa）和Android （.apk）版本到 [AppForShare](https://appforshare.io/) 从您的终端或CI 并为你的测试者提供安装链接和二维码页面。

```sh
export APPFORSHARE_TOKEN=afs_...   # Dashboard > Settings > API tokens (Pro and Team)
npx appforshare upload build/MyApp.ipa --notes "Fixes the login crash"
```

该命令打印安装链接。 `--json` 打印 `{ url, slug, name, version, expiresAt, readiness, findings, channel }`. 在GitHub Actions中，链接也被写入步骤输出 `url`， `slug`， `readiness` 和, `--channel`， `channel_url`.

大型构建以32 MB的块上传，并在断开连接后继续。

## 命令

| 命令 | 它是做什么的 |
| --- | --- |
| `appforshare upload <file>` | 上传一个构建(。Ipa，拉链。App, .apk或。Aab)，打印其安装链接和存储准备状态。 `--password`， `--email <up to 5>`， `--notes` (或 `--comment`)， `--channel` |
| `appforshare builds` | 列出最近的版本(`--platform ios|android`， `--app <bundle id>`， `--project <id>`， `--limit <n>`） |
| `appforshare latest` | 安装最新版本的链接(相同的过滤器，加上 `--channel <name>`） |
| `appforshare promote <id|slug> --channel <name>` | 把一个构建放到一个渠道中（Beta, Live）；在旧版本中执行此操作会将通道向后滚动 |
| `appforshare feedback-task <feedback id>` | 从测试人员反馈报告中添加一个任务到它的项目任务板（团队） |
| `appforshare activity [--project <id>] [--kind <kind>]` | 工作区活动，最新优先：上传、渠道、反馈、任务、发布检查表、链接控制（团队） |
| `appforshare send-feedback <feedback id> --to <linear|jira>` | 根据测试人员的反馈报告，在工作区的Linear或Jira中提出一个问题，并附上它的屏幕截图（Pro和Team） |
| `appforshare checklist <id|slug>` | 一个构建版本的发布清单，打开的阻塞以及门控通道（Live）是否接受它（Team） |
| `appforshare link <id|slug> [--pause|--resume] [--stop <date|off>] [--max-installs <n|off>]` | 暂停安装链接，在某个日期后停止它或限制其安装（专业和团队） |
| `appforshare testflight <url|off> --channel <name> --app <bundle id>` | TestFlight公开链接为一个渠道：iPhone和iPad访问者访问TestFlight， Android访问者获得最新的APK （Pro和Team） |
| `appforshare info <id|slug>` | 版本，大小，安装，链接，为什么测试者的手机可能会拒绝它，以及每个商店准备找到它的修复 |
| `appforshare installs <id|slug>` | 谁安装了构建：设备、操作系统、国家和测试人员 |
| `appforshare email <id|slug> --to <emails>` | 通过电子邮件将安装链接发送到最多5个地址；没有人会得到两次相同的构建（职业和团队） |
| `appforshare channel-address <address> --channel <name> --app <bundle id>` | 给一个频道自己的链接/c/；旧的会持续重定向30天（专业和团队） |
| `appforshare delete <id|slug> --yes` | 删除构建；它可以从仪表板恢复7天 |
| `appforshare feedback [id|slug] [--status open|resolved|all]` | 测试者的反馈从安装页面，最新的第一，与设备和仪表板链接 |
| `appforshare whoami` | 令牌的帐户、角色和计划 |

所有的命令 `--json`.

## 频道（Beta版、直播版）

```sh
npx appforshare upload app-release.apk --channel beta
npx appforshare promote 12345 --channel live
```

一个频道有一个链接和QR码，永远不会改变，总是打开最新的版本，在iPhone或 Android。该通道在您第一次使用其名称时创建。专业和团队计划。

## 使管道在存储准备上失败

```sh
npx appforshare upload app-release.apk --fail-on blocked
```

构建被上传，其链接以任何方式工作。与 `--fail-on blocked` 命令以代码2退出，当 存储准备检查找到一个阻塞器（例如可调试的构建、调试签名密钥、旧目标） API级别或iOS SDK)。 `--fail-on review` 在需要查看的发现上也失败了。检查是关于的指导 目前的App Store和b谷歌Play规则，并没有承诺获得批准。

## 常见问题

### appforshare 是什么？

从终端或CI上传iOS和Android版本到AppForShare，并获得安装链接。

### 如何安装 appforshare？

在项目目录运行 npm install appforshare，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 appforshare，可以用 npx appforshare 直接运行。

### appforshare 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/appforshare 是否存在。

### appforshare 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### appforshare 可以商用吗？

appforshare 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### appforshare 还在维护吗？

最新版本 1\.10\.1 发布于 2026/11/03（今天）；至今共发布 13 个版本，其中过去 12 个月发布了 13 个；首次发布于 2026/10/31。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。