127 lines
3.3 KiB
Markdown
127 lines
3.3 KiB
Markdown
# Adapty 命令行管理工具
|
||
|
||
`CLI` `订阅管理` `应用内购买` `Node.js` `开发工具`
|
||
|
||
<a href="https://adapty.io/?utm_source=github&utm_medium=referral&utm_campaign=adapty-cli">
|
||
<img src="https://adapty-portal-media-production.s3.amazonaws.com/github/logo-adapty-new.svg">
|
||
</a>
|
||
|
||
# Adapty CLI
|
||
|
||
[Adapty 开发者命令行工具](https://adapty.io/docs/developer-cli)。在终端中管理应用、产品、付费墙、投放位置和访问级别。
|
||
|
||
## 安装
|
||
|
||
```sh
|
||
npm install -g adapty
|
||
```
|
||
|
||
需要 Node.js >= 18。
|
||
|
||
## 认证
|
||
|
||
```sh
|
||
adapty auth login
|
||
```
|
||
|
||
打开浏览器进行 OAuth 设备流认证。Token 存储于 `~/.config/adapty/config.json`。
|
||
|
||
可通过 `ADAPTY_TOKEN` 环境变量覆盖：
|
||
|
||
```sh
|
||
ADAPTY_TOKEN=your-token adapty apps list
|
||
```
|
||
|
||
其他认证命令：
|
||
|
||
```sh
|
||
adapty auth whoami # 验证 token，显示用户信息
|
||
adapty auth status # 显示本地认证状态
|
||
adapty auth logout # 清除本地存储的 token
|
||
adapty auth revoke # 在服务端撤销 token 并清除本地记录
|
||
```
|
||
|
||
## 命令
|
||
|
||
所有资源命令都需要 `--app APP_ID`（UUID）。使用 `adapty apps list` 查找应用 ID。
|
||
|
||
### 应用
|
||
|
||
```sh
|
||
adapty apps list [--page N] [--page-size N]
|
||
adapty apps get APP_ID
|
||
adapty apps create --title "My App" --platform ios --apple-bundle-id com.example.app
|
||
adapty apps update APP_ID [flags]
|
||
```
|
||
|
||
### 产品
|
||
|
||
```sh
|
||
adapty products list --app UUID [--page N] [--page-size N]
|
||
adapty products get --app UUID PRODUCT_ID
|
||
adapty products create --app UUID [flags]
|
||
adapty products update --app UUID PRODUCT_ID [flags]
|
||
```
|
||
|
||
### 付费墙
|
||
|
||
```sh
|
||
adapty paywalls list --app UUID [--page N] [--page-size N]
|
||
adapty paywalls get --app UUID PAYWALL_ID
|
||
adapty paywalls create --app UUID --title "Name" --product-id UUID1 [--product-id UUID2]
|
||
adapty paywalls update --app UUID PAYWALL_ID [flags]
|
||
```
|
||
|
||
### 投放位置
|
||
|
||
```sh
|
||
adapty placements list --app UUID [--page N] [--page-size N]
|
||
adapty placements get --app UUID PLACEMENT_ID
|
||
adapty placements create --app UUID [flags]
|
||
adapty placements update --app UUID PLACEMENT_ID [flags]
|
||
```
|
||
|
||
### 访问级别
|
||
|
||
```sh
|
||
adapty access-levels list --app UUID [--page N] [--page-size N]
|
||
adapty access-levels get --app UUID ACCESS_LEVEL_ID
|
||
adapty access-levels create --app UUID [flags]
|
||
adapty access-levels update --app UUID ACCESS_LEVEL_ID [flags]
|
||
```
|
||
|
||
### 全局参数
|
||
|
||
| 参数 | 说明 |
|
||
| ------------- | --------------------------------- |
|
||
| `--json` | 以 JSON 格式输出 |
|
||
| `--help` | 显示帮助 |
|
||
| `--page` | 页码（默认：1） |
|
||
| `--page-size` | 每页条数（默认：20，最大：100） |
|
||
|
||
## 环境变量
|
||
|
||
| 变量 | 说明 |
|
||
| ---------------- | --------------------------------------------------------------------------------- |
|
||
| `ADAPTY_TOKEN` | 覆盖存储的认证 token |
|
||
| `ADAPTY_API_URL` | 覆盖 API 基础地址（默认：`https://api-admin.adapty.io/api/v1/developer`） |
|
||
|
||
## Claude Code 技能
|
||
|
||
为 Claude Code 安装 Adapty CLI 技能：
|
||
|
||
```sh
|
||
npx skills add adaptyteam/adapty-cli --skill adapty-cli
|
||
```
|
||
|
||
## 开发
|
||
|
||
```sh
|
||
pnpm install
|
||
pnpm build
|
||
./bin/run.js apps list
|
||
```
|
||
|
||
## 许可证
|
||
|
||
MIT |