@crvouga/mockingbird-service-apple

中文文档
0.10.0发布于 2026/11/11MITTypeScriptES Module构建来源已验证近 30 天下载 3156

国产苹果公售商API模拟器,带有本土取名空间,检查站和测试控制.

中文使用文档
文档目录3 节
  1. 安装
  2. 使用量
  3. API 密码

@crvouga/ mockingbird-service-apple (英语)

本地模拟器。 真正的API合同. 部分 嘲笑鸟。 。 。 .

OAuth授权,令牌交换,JWKS. 通过Mockingbird的便携式抓取运行时间,并带有SQLite坚持性,命名空间,检查站,断层和管理员控制等功能.

安装

npm install @crvouga/mockingbird-service-apple

使用量

import * as oidc from "openid-client"
import { createServer } from "@crvouga/mockingbird-service-apple/server"

const server = await createServer({ seed: 1 })
const redirect_uri = "http://localhost:3000/callback"

// The OpenID Connect client your application already uses. Only the issuer changes: the
// emulator instead of https://appleid.apple.com (allowInsecureRequests permits plain http).
const apple = await oidc.discovery(new URL(server.url), "com.example.web", "mock-client-secret", undefined, {
  execute: [oidc.allowInsecureRequests],
})
const signIn = oidc.buildAuthorizationUrl(apple, { redirect_uri, scope: "openid email name" })

// Test setup: stand in for the user choosing an account on the emulator's sign-in page.
const chosen = await fetch(`${server.url}/auth/authorize/callback`, {
  method: "POST",
  redirect: "manual",
  body: new URLSearchParams({ ...Object.fromEntries(signIn.searchParams), email: "[email protected]" }),
})

const tokens = await oidc.authorizationCodeGrant(apple, new URL(chosen.headers.get("location") ?? ""))
console.log(tokens.claims()?.email) // [email protected]

await server.close()

API 密码

  • AppleAPI:便携式提供者实例;接受SQLite,命名空间,时钟,定着和基底Url.
  • createRuntime:共享运行时间,包括本地命名空间和检查站控制.
  • APPLE_NAMESPACE: 默认存储名空间.
  • document, (中文(简体) ), operationIds, (中文(简体) ), supportedOperationIds: 注册供应商路线盘点.
  • createServer, (中文(简体) ), DEFAULT_PORT, (中文(简体) ), serveTarget 从 /server:回放收听器和CLI配置.

fixtures 接受合成供应商种子记录. reset() 恢复默认值。 模拟0.12.1只是一个测试神谕,从来不是一个运行时间依赖. 在Apache-2.0下移植的供应商操作员保留其许可证和归属;见LICENSE EMULATE和TIII PARTY NOTICES.md.

见 支助 覆盖范围和限度以及 API 证据.md 用于验证状态.

版本与发布记录

@crvouga/mockingbird-service-apple 共发布 20 个版本,首次发布于 2026/10/11;过去 12 个月发布了 20 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.10.0latest2026/11/11今天
0.9.92026/11/038 天前
0.9.82026/11/038 天前
0.9.72026/11/038 天前
0.9.62026/11/038 天前
0.9.52026/11/038 天前

关于 @crvouga/mockingbird-service-apple 的常见问题

@crvouga/mockingbird-service-apple 是什么?

国产苹果公售商API模拟器,带有本土取名空间,检查站和测试控制.

如何安装 @crvouga/mockingbird-service-apple?

在项目目录运行 npm install @crvouga/mockingbird-service-apple,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mockingbird-apple,可以用 npx mockingbird-apple 直接运行。

@crvouga/mockingbird-service-apple 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@crvouga/mockingbird-service-apple 支持 ESM 还是 CommonJS?

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

@crvouga/mockingbird-service-apple 可以商用吗?

@crvouga/mockingbird-service-apple 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@crvouga/mockingbird-service-apple 的下载量有多少?

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

@crvouga/mockingbird-service-apple 还在维护吗?

最新版本 0.10.0 发布于 2026/11/11(今天);至今共发布 20 个版本,其中过去 12 个月发布了 20 个;首次发布于 2026/10/11。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。