# @efffrida/gplayapi 中文文档

规范地址：https://npmcn.com/package/%40efffrida/gplayapi/

版本：0\.0\.43
npm 元数据更新时间：2026-11-12T16:00:16.916Z
中文译文更新时间：2026-11-14T02:52:58.472Z
软件包许可：GPL-3\.0-only

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

原始 npm 页面：https://www.npmjs.com/package/%40efffrida/gplayapi
原文对照：https://npmcn.com/package/%40efffrida/gplayapi/?lang=original
项目主页：https://github.com/leonitousconforti/efffrida
源码仓库：https://github.com/leonitousconforti/efffrida

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

- 包体积（解压后）：1 MB，40 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=24
- 运行依赖：1 个
- peer 依赖：effect 4\.1\.4
- 首次发布：2025-11-17T22:15:48.182Z
- 最新版本发布：2026-11-12T16:00:16.431Z
- 近 30 天下载量：2471（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：42（近 12 个月 42 个）

## 中文简介

Google 用于下载应用程序的 API 客户端

## 安装

```sh
npm install @efffrida/gplayapi
```

也可以使用：`pnpm add @efffrida/gplayapi`、`yarn add @efffrida/gplayapi`、`bun add @efffrida/gplayapi`

## README

# @efffrida/gplayapapi (英语)

非官方 Google Play Store API 直接从 Google 下载APK 游戏商店.

商店的原生取出端点暴露为效果: `details` 财务报告和审定财务报表 `bulkDetails` 用于应用元数据, `purchase` 财务报告和审定财务报表 `delivery` 用于获取 下载标志,和 `downloadToStreams` 财务报告和审定财务报表 `downloadToDisk` 为拉倒 aPK 及其分拆和扩展文件.

### 示例用途

```typescript
import { Effect, Layer } from "effect";

import { NodeHttpClient, NodeServices } from "@effect/platform-node";
import { AndroidDevice, GooglePlayApi, PlayAccount } from "@efffrida/gplayapi";

const PlayLive = Layer.mergeAll(
    AndroidDevice.layerEmbeddedPixel7a,
    NodeHttpClient.layerUndici,
    PlayAccount.layerConfig()
).pipe(Layer.provideMerge(NodeServices.layer));

const program = Effect.gen(function* () {
    const { item } = yield* GooglePlayApi.details("com.nimblebit.tinytower");
    yield* Effect.log(`${item?.title} ${item?.details?.appDetails?.versionString}`);

    const files = yield* GooglePlayApi.downloadToDisk("com.nimblebit.tinytower");
    // ...
}).pipe(Effect.scoped, Effect.provide(PlayLive));
```

### 服务

三事须供.

**设备**,决定商店看到的硬件指纹 因而创造它. `AndroidDevice.layerEmbeddedPixel7a` 船舶 使用软件包; 其他设备可以使用Aurora商店样式构建 属性文件为 `AndroidDevice.fromPropertiesFile`。 。 。 .

**一个 `HttpClient`**,无论哪个平台包适合运行时间.

**A 类 `PlayAccount`**,它决定了谷歌如何播放证书. 没有默认,所以选择其中之一:

-   `layerAuroraDispenser(url?)` 交出奥罗拉的匿名证 存储相容的放送器, `https://auroraoss.com/api/auth` 默认。 这个 托管一个块和速率限制数据中心 ip 范围, 因此它不适合 对于任何运行在云基础设施.
-   `layerConfig({token?})` 校对:soup 配置提供者,默认为 `GPLAY_AUTH_TOKEN` 环境 变量.
-   `layerStatic(credentials)` 提供已经持有的全权证书.

设备从自己和账户中获取认证信头,然后缓存 他们30分钟。 401或403从店里赶走他们 所以.. 下一次呼叫会获得一个新组合。 运输故障、超时和408,429,500, 502,503和504回應被以回放方式再作回放.

`downloadToDisk` 将每个文件写入范围化的临时文件,并检查其 当它流出时完整性, 所以当周围的文件被删除 `Scope` 关闭。 复制或移动到别处 如果需要超过寿命 这个.

## 常见问题

### @efffrida/gplayapi 是什么？

Google 用于下载应用程序的 API 客户端

### 如何安装 @efffrida/gplayapi？

在项目目录运行 npm install @efffrida/gplayapi，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：effect（4\.1\.4）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @efffrida/gplayapi 支持 TypeScript 吗？

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

### @efffrida/gplayapi 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @efffrida/gplayapi 需要什么版本的 Node\.js？

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

### @efffrida/gplayapi 可以商用吗？

@efffrida/gplayapi 使用 GPL-3\.0-only 许可。强 Copyleft：分发包含该代码的软件时，整个作品需以 GPL-3\.0 兼容许可开源，并附带专利与反锁定条款。仅内部使用不触发此义务。以上为概括，不构成法律意见，请以许可原文为准。

### @efffrida/gplayapi 的下载量有多少？

根据 npm 官方下载统计，@efffrida/gplayapi 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,471 次，日均约 82 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @efffrida/gplayapi 还在维护吗？

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