@capacitor-community/advertising-id

中文文档
8.0.0发布于 2025/12/26MITTypeScriptESM + CJS零依赖近 30 天下载 10.1万

Allows access to the IDFA (iOS) and GAID (Android)

原始使用文档
文档目录9 节
  1. Install
  2. iOS
  3. Android
  4. Variables
  5. API
  6. requestTracking()
  7. getAdvertisingId()
  8. getAdvertisingStatus()
  9. Type Aliases

@capacitor-community/advertising-id

Allows access to the IDFA (iOS) and GAID (Android)

Install

npm install @capacitor-community/advertising-id
npx cap sync

iOS

iOS requires the following usage description be added and filled out for your app in Info.plist to use the requestTracking() method:

  • NSUserTrackingUsageDescription (Privacy - Tracking Usage Description)

Android

Variables

This plugin will use the following project variables (defined in your app's variables.gradle file):

  • playServicesAdsId version of com.google.android.gms:play-services-ads-identifier (default: 18.2.0)

API

requestTracking()

requestTracking() => Promise<{ value: AdvertisingStatus; }>

Returns: Promise<{ value: AdvertisingStatus; }>


getAdvertisingId()

getAdvertisingId() => Promise<{ id: string; status: AdvertisingStatus; }>

Returns: Promise<{ id: string; status: AdvertisingStatus; }>


getAdvertisingStatus()

getAdvertisingStatus() => Promise<{ status: AdvertisingStatus; }>

Returns: Promise<{ status: AdvertisingStatus; }>


Type Aliases

AdvertisingStatus

'Authorized' | 'Denied' | 'Not Determined' | 'Restricted'

版本与发布记录

@capacitor-community/advertising-id 共发布 9 个版本,首次发布于 2022/04/26;过去 12 个月发布了 1 个版本。

版本发布日期距今
8.0.0latest2025/12/2610 个月前
7.1.02025/08/221.2 年前
7.0.02025/01/251.8 年前
6.0.02024/05/182 年前
5.0.02023/05/193 年前
4.0.02023/02/033 年前

其他发布通道:next → 2.0.0-0。

关于 @capacitor-community/advertising-id 的常见问题

@capacitor-community/advertising-id 是什么?

Allows access to the IDFA (iOS) and GAID (Android)

如何安装 @capacitor-community/advertising-id?

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

@capacitor-community/advertising-id 支持 TypeScript 吗?

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

@capacitor-community/advertising-id 支持 ESM 还是 CommonJS?

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

@capacitor-community/advertising-id 可以商用吗?

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

@capacitor-community/advertising-id 的下载量有多少?

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

@capacitor-community/advertising-id 还在维护吗?

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