@capgo/capacitor-purchases

中文文档
5.0.8发布于 2023/07/31MITTypeScriptESM + CJS零依赖近 30 天下载 2461

使用 EvolutionCat sdk 方便的应用程序订阅

此软件包已被标记为弃用

Transfered to RevenueCat ORG use @revenuecat/purchases-capacitor

中文使用文档
文档目录20 节
  1. 请检查access-date=中的日期值 (帮助) Capgo — 电容器的实时更新
  2. 逐级授课
  3. 安装
  4. 机器人
  5. 变量
  6. 配置
  7. 迁移v2
  8. API 密码
  9. 设置(...)
  10. 添加Listener('购买更新',...)
  11. 获取 Offenings ()
  12. 购买包(...)
  13. 恢复纯度( C)
  14. 属性(...)
  15. 登录(...)
  16. 日志输出( C)
  17. 获取客户端信息( C)
  18. 设置调试日志
  19. 接口
  20. 数字

电容器购买

Capgo - Instant updates for capacitor

使用 FinancilsCat SDK 方便的应用程序订阅

FinanceCat是一个第三方工具,它处理我们的所有困难,直到每月收入一万美元为止

SDK v4 以 Lastes FinancientCat 执行控制器

收入表 :

逐级授课

https://capgo.app/blog/in-app-sessers-capicor/ 页面存档备份,存于互联网档案馆

安装

npm install @capgo/capacitor-purchases
pnpm dlx cap sync

机器人

把这个添加到您的机器人清单中 android/app/src/main/AndroidManifest.xml

<uses-permission android:name="com.android.vending.BILLING"/>

变量

此插件将使用以下工程变量( 在您的应用程序中定义) variables.gradle 文件名 :

  • $kotlinVersion 版本 org.jetbrains.kotlin:kotlin-stdlib-jdk7 (默认 : 1.7.21(中文(简体) )

如果您有汇编问题 Duplicate class androidx.lifecycle.ViewModelLazy 我在这里找到了为我工作的解决方案: https://stackoverflow.com/ questions/73406969/ 二重级-同级-机器人-生命周期-观光模型lazy-found-in-modules-lifecycle-view 互联网档案馆的存檔,存档日期2013-10-02

添加这个

configurations {
    all {
        exclude group: 'androidx.lifecycle', module: 'lifecycle-runtime-ktx'
        exclude group: 'androidx.lifecycle', module: 'lifecycle-viewmodel-ktx'
    }
}
an

文件行 2 android/app/build.gradle

配置

此插件不需要配置 .

迁移v2

获取 PurchaserInfo 成为获取 CustomeInfo 购买者信息成为客户信息 将交易恢复为还原

详情请见此: https://github.com/RevenueCat/购买-android/blob/main/migrations/v5-MIGARINE.md

API 密码

设置(...)

setup(data: { apiKey: string; appUserID?: string; observerMode?: boolean; enableAdServicesAttribution?: boolean; collectDeviceIdentifiers?: boolean; }) => any

设置您的 API 密钥和应用程序用户 ID .

参数类型
data{ apiKey: string; appUserID?: string; observerMode?: boolean; enableAdServicesAttribution?: boolean; collectDeviceIdentifiers?: boolean; }

回返情况: any


添加Listener('购买更新',...)

addListener(eventName: "purchasesUpdate", listenerFunc: (data: { purchases: Package; customerInfo: CustomerInfo; }) => void) => Promise<PluginListenerHandle> & PluginListenerHandle

当部分结果成真并收到结果时调用

提供了部分结果.

参数类型
eventName'purchasesUpdate'
listenerFunc(data: { purchases: Package; customerInfo: CustomerInfo; }) => void

回返情况: any

自: 2.0.2 (中文(简体) )


获取 Offenings ()

getOfferings() => any

获得 提供 在收入控制仪表板中配置

回返情况: any


购买包(...)

purchasePackage(data: { identifier: string; offeringIdentifier: string; oldSKU?: string | null; }) => any

买个东西

参数类型
data{ identifier: string; offeringIdentifier: string; oldSKU?: string | null; }

回返情况: any


恢复纯度( C)

restorePurchases() => any

还原一个用户的前身,并将其应用用户ID链接到任何用户也使用这些用户的上.

回返情况: any


属性(...)

setAttributes(data: { attributes: { [key: string]: string | null; }; }) => any

订阅者属性对于存储用户上的额外,结构化的信息是有用的. 由于属性可以使用公钥书写,因此不应用于 管理安全或敏感的信息,如订阅状态,硬币等.

以"$"开头的关键名是FOVCat所使用的保留名. 完整的密钥列表 限制是指我们的指南: https://docs.revenuecat.com/docs/订阅者属性

参数类型
data{ attributes: { [key: string]: string | null; }; }

回返情况: any


登录(...)

logIn(data: { appUserID: string; }) => any

此函数将使用应用程序UserID登录当前用户 。 通常在登录后使用 以识别用户而无需调用配置.

参数类型
data{ appUserID: string; }

回返情况: any


日志输出( C)

logOut() => any

登录客户端清除保存的应用程序用户ID 。 这将生成随机用户ID并保存在缓存中. 如果当前用户已经匿名, 这将产生一个错误 .

回返情况: any


获取客户端信息( C)

getCustomerInfo() => any

获取当前购买者的信息 。 此调用将返回缓存的购买者信息, 除非缓存已停止, 在这种情况下, 它会发出网络呼叫 从服务器上取回它.

回返情况: any


设置调试日志

setDebugLogsEnabled(data: { enabled: boolean; }) => any

启用/ 禁用调试日志

参数类型
data{ enabled: boolean; }

回返情况: any


接口

软件包

包含可供用户购买的产品信息. 更多信息见 https://docs.revenuecat.com/docs/ 应享权利

Prop类型说明
identifierstring此软件包的独特标识符 。 可以是预定义的软件包类型或自定义类型 .
packageTypePACKAGE_TYPE软件包 类型。 将是[PACKAGE TYPE]之一.
productProduct产品 分配给此软件包.
offeringIdentifierstring提供 此包属于 .

产品

Prop类型说明
identifierstring产品 爱德.
descriptionstring产品说明.
titlestring产品名称.
pricenumber产品以当地货币计价.
priceStringstring项目的格式价格,包括其货币标志,如3.99欧元.
currencyCodestring价格和原价的货币代码.
currencySymbolstring价格和原价的货币符号.
isFamilyShareableboolean布尔表示产品是否与家族相通
subscriptionGroupIdentifierstring产品组标识符 .
subscriptionPeriodSubscriptionPeriod这个 产品 子脚本组标识符.
introductoryPriceSKProductDiscount | null这个 产品 介绍性价格.
discounts{}这个 产品 折扣列表.

订阅

Prop类型说明
numberOfUnitsnumber订阅期间单位数.
unitnumber订阅时间单位.

SK 生产贴现

Prop类型说明
identifierstring这个 产品 折扣标识符.
typenumber这个 产品 折扣类型.
pricenumber这个 产品 折扣价格.
priceStringstring项目的格式价格,包括其货币标志,如3.99欧元.
currencySymbolstring这个 产品 折扣货币符号.
currencyCodestring这个 产品 折价货币代码.
paymentModenumber这个 产品 折扣支付模式.
numberOfPeriodsnumber这个 产品 期间的折扣数.
subscriptionPeriodSubscriptionPeriod这个 产品 折扣订阅期.

客户信息

Prop类型说明
entitlementsEntitlementInfos该购买者信息附带的权利
activeSubscriptions[string]一组活动订阅 skus
allPurchasedProductIdentifiers[string]一套已购买的、活跃和闲置的骷髅
nonSubscriptionTransactions{}返回用户所做的全部非订阅 。 定购日期为递增顺序.
latestExpirationDatestring | null所有购买的骷髅的最近到期日期
firstSeenstring此用户最早出现的日期见于FinancialCat.
originalAppUserIdstring原始 App 用户 ID为这个用户录制.
requestDatestring请求此信息的日期
originalApplicationVersionstring | null用户购买应用程序时返回应用程序版本的版本编号. 迁移到订阅时为外公用户使用此功能 。 这与最初购买时Info.plist文件中的CFBundleVersion(在iOS)的值相对应. 这在Android总是无效的
originalPurchaseDatestring | null用户购买应用程序时返回该应用程序版本的购买日期 。 迁移到订阅时为外公用户使用此功能 .
managementURLstring | nullURL来管理用户的主动订阅. 如果该用户有活跃的iOS订阅,这将指向App Store,如果用户有活跃的 Play Store 订阅,它会指向那里. 如果没有主动订阅, 则无效 。 如果不同平台有多个,则会指向设备商店.

应享权利信息

包含所有与用户相关的应享权利.

Prop类型说明
all{ [key: string]: EntitlementInfo; }所有地图 应享权利信息 (单位:千美元)PurchasesEntitlementInfo)对象(活性和活性),由应享权利标识符键入.
active{ [key: string]: EntitlementInfo; }活动地图 应享权利信息 (单位:千美元)PurchasesEntitlementInfo) 由应享权利标识符键入的对象.

应享权利信息

这个 应享权利信息 对象允许您访问所有关于用户应享权利状况的信息.

Prop类型说明
identifierstring收入控制仪表板中配置的应享权利标识符
isActiveboolean如果用户可以使用此权限, 则为真
willRenewboolean如果基本的订阅被设定为在计费期结束时续签( 过期) , 则为真 。 如果权利是终身的,则永远是真实的.
periodTypestring上一个时期为这一福利类型。 两者之一: NORMAL,INTRO,TRIAL.
latestPurchaseDatestring应享权利的最新购买或续签日期.
originalPurchaseDatestring购买这项权利的第一个日期.
expirationDatestring | null应享权利的终止日期可以是: null 终生访问。 如果 periodType 实值 trial,这是审判期满的日期.
storestring这个权利被解锁的商店。 无论是AppStore、macAppStore、游戏Store、条纹、宣传、未知的Store
productIdentifierstring解锁此权限的产品标识符
isSandboxboolean如果通过生产购买来解锁该权利,则是假的
unsubscribeDetectedAtstring | null检测到未订阅日期 。 可能会 null。 。 。 .
billingIssueDetectedAtstring | null发现开账单的日期。 可能会 null 如果没有计费问题或问题已经解决

交易

Prop类型说明
transactionIdentifierstring收入表 和交易有关.
productIdentifierstring产品 和交易有关.
purchaseDatestring以ISO 8601格式进行交易的购买日期.

插件听筒

Prop类型
remove() => any

提供

包含收入表盘中配置的所有报价. 更多信息见 https://docs.revenuecat.com/docs/ 应享权利

Prop类型说明
all{ [key: string]: Offering; }所有地图 提供 [purchas Offening] 被其识别符所键入的对象.
currentOffering | null目前在FormCat仪表板上配置的报价.

提供

赠品是套件的收藏品(PurchasesPackage可供用户购买. 更多信息见 https://docs.revenuecat.com/docs/ 应享权利

Prop类型说明
identifierstringFOENCAT仪表板中定义的独特标识符.
serverDescriptionstring提供 定义.
availablePackages{}矩阵 Package 可购买的对象.
lifetimePackage | null如果有的话,在FORSCat仪表板中配置的寿命包类型.
annualPackage | null年度软件包类型(如果有的话),配置在FORSCat仪表板中.
sixMonthPackage | null如果有的话,在FinancialCat仪表板中配置了6个月的包类型.
threeMonthPackage | null如果有的话,在FORSCat仪表板中配置了三个月包类型.
twoMonthPackage | null如果有的话,在FinancialCat仪表板中配置了两个月包类型.
monthlyPackage | null如果有的话,在FOFFCat仪表板中配置的月包类型.
weeklyPackage | null如果有的话,在FonctionCat仪表板中配置的每周包类型.

登录结果

持有日志结果

Prop类型说明
customerInfoCustomerInfo用户的购买者信息 .
createdboolean如果电话导致在ForwardCat后端中创建了新用户,则情况确实如此.

数字

包件类型

成员数值说明
UNKNOWN"UNKNOWN"使用自定义标识符定义的软件包 .
CUSTOM"CUSTOM"使用自定义标识符定义的软件包 .
LIFETIME"LIFETIME"配置了预定义寿命标识符的软件包 .
ANNUAL"ANNUAL"配置了预定义的年度标识符的软件包 .
SIX_MONTH"SIX_MONTH"配置了预定义的6个月标识符的软件包 .
THREE_MONTH"THREE_MONTH"配置了预定义的三个月标识符的软件包 .
TWO_MONTH"TWO_MONTH"配置了预定义的两个月标识符的软件包 .
MONTHLY"MONTHLY"配置了预定义月标识符的软件包 .
WEEKLY"WEEKLY"配置了预定义的周标识符的软件包 .

版本与发布记录

@capgo/capacitor-purchases 共发布 94 个版本,首次发布于 2022/07/24;过去 12 个月发布了 0 个版本。

版本发布日期距今
5.0.8latest2023/07/313 年前
5.0.72023/07/173 年前
5.0.62023/07/033 年前
5.0.52023/06/153 年前
5.0.42023/06/153 年前
5.0.32023/06/123 年前

关于 @capgo/capacitor-purchases 的常见问题

@capgo/capacitor-purchases 是什么?

使用 EvolutionCat sdk 方便的应用程序订阅注意:该包已被作者标记为弃用——Transfered to RevenueCat ORG use @revenuecat/purchases-capacitor

如何安装 @capgo/capacitor-purchases?

在项目目录运行 npm install @capgo/capacitor-purchases,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@capacitor/core(^5.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@capgo/capacitor-purchases 支持 TypeScript 吗?

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

@capgo/capacitor-purchases 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@capgo/capacitor-purchases 可以商用吗?

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

@capgo/capacitor-purchases 的下载量有多少?

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

@capgo/capacitor-purchases 还在维护吗?

最新版本 5.0.8 发布于 2023/07/31(3 年前);至今共发布 94 个版本,其中过去 12 个月发布了 0 个;首次发布于 2022/07/24。作者已将其标记为弃用,新项目建议寻找替代方案。