# @capawesome/capacitor-react-hooks 中文文档

规范地址：https://npmcn.com/package/%40capawesome/capacitor-react-hooks/

版本：0\.1\.0
npm 元数据更新时间：2026-08-17T16:38:44.565Z
中文译文更新时间：2026-11-09T10:03:36.301Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40capawesome/capacitor-react-hooks
原文对照：https://npmcn.com/package/%40capawesome/capacitor-react-hooks/?lang=original
项目主页：https://capawesome.io/
源码仓库：https://github.com/capawesome-team/capacitor-react-hooks

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

- 包体积（解压后）：1.6 MB，778 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：0 个
- peer 依赖：@capacitor-firebase/analytics ^8\.0\.0，@capacitor-firebase/app ^8\.0\.0，@capacitor-firebase/app-check ^8\.0\.0，@capacitor-firebase/authentication ^8\.0\.0，@capacitor-firebase/crashlytics ^8\.0\.0，@capacitor-firebase/firestore ^8\.0\.0，@capacitor-firebase/functions ^8\.0\.0，@capacitor-firebase/messaging ^8\.0\.0，@capacitor-firebase/performance ^8\.0\.0，@capacitor-firebase/remote-config ^8\.0\.0，@capacitor-firebase/storage ^8\.0\.0，@capacitor-mlkit/barcode-scanning ^8\.0\.0，@capacitor-mlkit/digital-ink-recognition ^8\.0\.0，@capacitor-mlkit/document-scanner ^8\.0\.0，@capacitor-mlkit/entity-extraction ^8\.0\.0，@capacitor-mlkit/face-detection ^8\.0\.0，@capacitor-mlkit/face-mesh-detection ^8\.0\.0，@capacitor-mlkit/genai-image-description ^8\.0\.0，@capacitor-mlkit/genai-prompt ^8\.0\.0，@capacitor-mlkit/genai-proofreading ^8\.0\.0，@capacitor-mlkit/genai-rewriting ^8\.0\.0，@capacitor-mlkit/genai-speech-recognition ^8\.0\.0，@capacitor-mlkit/genai-summarization ^8\.0\.0，@capacitor-mlkit/image-labeling ^8\.0\.0，@capacitor-mlkit/language-identification ^8\.0\.0，@capacitor-mlkit/object-detection ^8\.0\.0，@capacitor-mlkit/pose-detection ^8\.0\.0，@capacitor-mlkit/selfie-segmentation ^8\.0\.0，@capacitor-mlkit/smart-reply ^8\.0\.0，@capacitor-mlkit/subject-segmentation ^8\.0\.0，@capacitor-mlkit/text-recognition ^8\.0\.0，@capacitor-mlkit/translation ^8\.0\.0，@capacitor/action-sheet ^8\.0\.0，@capacitor/app ^8\.0\.0，@capacitor/app-launcher ^8\.0\.0，@capacitor/background-runner ^3\.0\.0，@capacitor/barcode-scanner ^3\.0\.0，@capacitor/browser ^8\.0\.0，@capacitor/calendar ^1\.0\.0，@capacitor/camera ^8\.0\.0，@capacitor/clipboard ^8\.0\.0，@capacitor/contacts ^1\.0\.0，@capacitor/core \>=8\.0\.0，@capacitor/device ^8\.0\.0，@capacitor/dialog ^8\.0\.0，@capacitor/file-transfer ^2\.0\.0，@capacitor/file-viewer ^2\.0\.0，@capacitor/filesystem ^8\.0\.0，@capacitor/geolocation ^8\.0\.0，@capacitor/google-maps ^8\.0\.0，@capacitor/haptics ^8\.0\.0，@capacitor/inappbrowser ^4\.0\.0，@capacitor/keyboard ^8\.0\.0，@capacitor/local-notifications ^8\.0\.0，@capacitor/motion ^8\.0\.0，@capacitor/network ^8\.0\.0，@capacitor/preferences ^8\.0\.0，@capacitor/privacy-screen ^2\.0\.0，@capacitor/push-notifications ^8\.0\.0，@capacitor/screen-orientation ^8\.0\.0，@capacitor/screen-reader ^8\.0\.0，@capacitor/share ^8\.0\.0，@capacitor/splash-screen ^8\.0\.0，@capacitor/status-bar ^8\.0\.0，@capacitor/text-zoom ^8\.0\.0，@capacitor/toast ^8\.0\.0，@capawesome-team/capacitor-accelerometer ^8\.0\.0，@capawesome-team/capacitor-admob ^0\.0\.0，@capawesome-team/capacitor-android-battery-optimization ^8\.0\.0，@capawesome-team/capacitor-android-foreground-service ^8\.0\.0，@capawesome-team/capacitor-audio-player ^8\.0\.0，@capawesome-team/capacitor-audio-recorder ^8\.0\.0，@capawesome-team/capacitor-background-geolocation ^0\.0\.0，@capawesome-team/capacitor-barcode-scanner ^0\.0\.0，@capawesome-team/capacitor-barometer ^8\.0\.0，@capawesome-team/capacitor-biometrics ^0\.0\.0，@capawesome-team/capacitor-bluetooth-low-energy ^8\.0\.0，@capawesome-team/capacitor-calendar ^0\.0\.0，@capawesome-team/capacitor-contacts ^8\.0\.0，@capawesome-team/capacitor-datetime-picker ^8\.0\.0，@capawesome-team/capacitor-document-scanner ^0\.0\.0，@capawesome-team/capacitor-file-compressor ^8\.0\.0，@capawesome-team/capacitor-file-manager ^0\.0\.0，@capawesome-team/capacitor-file-opener ^8\.0\.0，@capawesome-team/capacitor-file-transfer ^0\.0\.0，@capawesome-team/capacitor-geocoder ^8\.0\.0，@capawesome-team/capacitor-geofences ^0\.0\.0，@capawesome-team/capacitor-health ^0\.0\.0，@capawesome-team/capacitor-llm ^0\.0\.0，@capawesome-team/capacitor-media-session ^8\.0\.0，@capawesome-team/capacitor-nfc ^8\.0\.0，@capawesome-team/capacitor-oauth ^0\.0\.0，@capawesome-team/capacitor-pedometer ^8\.0\.0，@capawesome-team/capacitor-printer ^8\.0\.0，@capawesome-team/capacitor-purchases ^0\.0\.0，@capawesome-team/capacitor-secure-preferences ^0\.0\.0，@capawesome-team/capacitor-share-target ^8\.0\.0，@capawesome-team/capacitor-speech-recognition ^8\.0\.0，@capawesome-team/capacitor-speech-synthesis ^8\.0\.0，@capawesome-team/capacitor-sqlite ^0\.0\.0，@capawesome-team/capacitor-vault ^0\.0\.0，@capawesome-team/capacitor-watch ^0\.0\.0，@capawesome-team/capacitor-wifi ^8\.0\.0，@capawesome-team/capacitor-zip ^8\.0\.0，@capawesome/capacitor-accessibility-preferences ^0\.0\.0，@capawesome/capacitor-action-sheet ^0\.0\.0，@capawesome/capacitor-age-signals ^0\.0\.0，@capawesome/capacitor-alarm ^0\.0\.0，@capawesome/capacitor-android-edge-to-edge-support ^8\.0\.0，@capawesome/capacitor-android-intent-launcher ^0\.0\.0，@capawesome/capacitor-android-sms-retriever ^0\.0\.0，@capawesome/capacitor-app-icon ^0\.0\.0，@capawesome/capacitor-app-integrity ^0\.0\.0，@capawesome/capacitor-app-language ^0\.0\.0，@capawesome/capacitor-app-launcher ^0\.0\.0，@capawesome/capacitor-app-review ^8\.0\.0，@capawesome/capacitor-app-shortcuts ^8\.0\.0，@capawesome/capacitor-app-tracking-transparency ^0\.0\.0，@capawesome/capacitor-app-update ^8\.0\.0，@capawesome/capacitor-apple-sign-in ^0\.0\.0，@capawesome/capacitor-asset-manager ^8\.0\.0，@capawesome/capacitor-audio-session ^0\.0\.0，@capawesome/capacitor-background-task ^8\.0\.0，@capawesome/capacitor-badge ^8\.0\.0，@capawesome/capacitor-battery ^0\.0\.0，@capawesome/capacitor-clipboard ^0\.0\.0，@capawesome/capacitor-cloudinary ^8\.0\.0，@capawesome/capacitor-compass ^0\.0\.0，@capawesome/capacitor-crisp ^0\.0\.0，@capawesome/capacitor-device-info ^0\.0\.0，@capawesome/capacitor-dialog ^0\.0\.0，@capawesome/capacitor-exif ^0\.0\.0，@capawesome/capacitor-facebook-sign-in ^0\.0\.0，@capawesome/capacitor-file-picker ^8\.0\.0，@capawesome/capacitor-formbricks ^0\.0\.0，@capawesome/capacitor-google-sign-in ^0\.0\.0，@capawesome/capacitor-grafana-faro ^0\.0\.0，@capawesome/capacitor-gyroscope ^0\.0\.0，@capawesome/capacitor-haptics ^0\.0\.0，@capawesome/capacitor-home-indicator ^0\.0\.0，@capawesome/capacitor-in-app-browser ^0\.0\.0，@capawesome/capacitor-install-referrer ^0\.0\.0，@capawesome/capacitor-intercom ^0\.0\.0，@capawesome/capacitor-intune ^0\.0\.0，@capawesome/capacitor-keep-awake ^0\.0\.0，@capawesome/capacitor-libsql ^0\.0\.0，@capawesome/capacitor-light-sensor ^0\.0\.0，@capawesome/capacitor-live-update ^8\.0\.0，@capawesome/capacitor-localization ^0\.0\.0，@capawesome/capacitor-mail-composer ^0\.0\.0，@capawesome/capacitor-managed-configurations ^8\.0\.0，@capawesome/capacitor-maplibre ^0\.0\.0，@capawesome/capacitor-maps-launcher ^0\.0\.0，@capawesome/capacitor-navigation-bar ^8\.0\.0，@capawesome/capacitor-network ^0\.0\.0，@capawesome/capacitor-nodejs ^0\.0\.0，@capawesome/capacitor-passkeys ^0\.0\.0，@capawesome/capacitor-password-autofill ^0\.0\.0，@capawesome/capacitor-pdf-generator ^0\.0\.0，@capawesome/capacitor-pdf-viewer ^0\.0\.0，@capawesome/capacitor-permissions ^0\.0\.0，@capawesome/capacitor-phone-dialer ^0\.0\.0，@capawesome/capacitor-photo-editor ^8\.0\.0，@capawesome/capacitor-photo-manipulator ^0\.0\.0，@capawesome/capacitor-pixlive ^0\.0\.0，@capawesome/capacitor-posthog ^8\.0\.0，@capawesome/capacitor-privacy-screen ^0\.0\.0，@capawesome/capacitor-proximity-sensor ^0\.0\.0，@capawesome/capacitor-realtimekit ^0\.0\.0，@capawesome/capacitor-root-detection ^0\.0\.0，@capawesome/capacitor-screen-brightness ^0\.0\.0，@capawesome/capacitor-screen-orientation ^8\.0\.0，@capawesome/capacitor-screen-reader ^0\.0\.0，@capawesome/capacitor-screenshot ^8\.0\.0，@capawesome/capacitor-settings-launcher ^0\.0\.0，@capawesome/capacitor-shake ^0\.0\.0，@capawesome/capacitor-silent-mode ^0\.0\.0，@capawesome/capacitor-sim ^0\.0\.0，@capawesome/capacitor-sms-composer ^0\.0\.0，@capawesome/capacitor-square-mobile-payments ^0\.0\.0，@capawesome/capacitor-superwall ^0\.0\.0，@capawesome/capacitor-system-webview ^0\.0\.0，@capawesome/capacitor-text-interaction ^0\.0\.0，@capawesome/capacitor-text-zoom ^0\.0\.0，@capawesome/capacitor-thermal-state ^0\.0\.0，@capawesome/capacitor-toast ^0\.0\.0，@capawesome/capacitor-torch ^8\.0\.0，@capawesome/capacitor-volume ^0\.0\.0，@capawesome/capacitor-wallet ^0\.0\.0，@capawesome/capacitor-youtube-player ^0\.0\.0，react ^18\.0\.0 \|\| ^19\.0\.0
- 首次发布：2026-08-17T16:34:56.112Z
- 最新版本发布：2026-08-17T16:38:44.245Z
- 近 30 天下载量：2941（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 2 个）

## 中文简介

电容插件的反应钩

## 安装

```sh
npm install @capawesome/capacitor-react-hooks
```

也可以使用：`pnpm add @capawesome/capacitor-react-hooks`、`yarn add @capawesome/capacitor-react-hooks`、`bun add @capawesome/capacitor-react-hooks`

## README

# @ capawesome/ 电容- react- hooks

[![npm version](https://img.shields.io/npm/v/@capawesome/capacitor-react-hooks)](https://www.npmjs.com/package/@capawesome/capacitor-react-hooks) [![npm downloads](https://img.shields.io/npm/dm/@capawesome/capacitor-react-hooks)](https://www.npmjs.com/package/@capawesome/capacitor-react-hooks) [![license](https://img.shields.io/npm/l/@capawesome/capacitor-react-hooks)](https://github.com/capawesome-team/capacitor-react-hooks/blob/main/LICENSE)

反应钩 [电容](https://capacitorjs.com/) 插件:反应状态,生命周期管理的收听器,以及您已经使用的插件API的权限处理.

## 特征

-   🪝 **每个插件有一个子路径** – 只导入您使用的, 完全可树动
-   🔌 **插件保持可选状态** – 每个电容插件都是可选的对等依赖
-   🔁 **共享本地听众** – 每个事件都有一个插件收听器, 不管有多少组件订阅
-   🧹 **正确的清理** – 严格Mode安全订阅/不订阅,包括同步订阅 `addListener` 控件
-   🖥️ **安保部门安全** - 导入任何模块均无副作用;模块范围没有浏览器 API
-   🚀 **发射活动** - 捕捉在React上架前起火的事件(例如通知自带)并重放到你的钩上
-   🔑 **作为钩子的权限** – 说吧 – `{ status, check, request }` 对每个有权限 API 的插件
-   🛡️ **类型脚本** - 根据每个插件本身的定义键入

## 安装

```bash
npm install @capawesome/capacitor-react-hooks
```

安装您想要使用钩子的电容插件, 例如 :

```bash
npm install @capacitor/network
```

要求反应出18或19和Capacitor 8.

## 使用量

从插件的子路径导入钩子 :

```tsx
import { useNetworkStatus } from '@capawesome/capacitor-react-hooks/capacitor/network';

const ConnectionBadge = () => {
  const status = useNetworkStatus();
  if (!status) {
    return null;
  }
  return <span>{status.connected ? 'Online' : 'Offline'}</span>;
};
```

权限和必要方法:

```tsx
import {
  useGeolocationPermissions,
  useWatchPosition,
} from '@capawesome/capacitor-react-hooks/capacitor/geolocation';

const Tracker = () => {
  const { status, request } = useGeolocationPermissions();
  const { position, error } = useWatchPosition({ enableHighAccuracy: true });
  // ...
};
```

### 发射活动

有些事件可以在 React 挂起前开火, 例如用户点击推力 启动应用程序的通知 `createRoot` 他们 重放到第一个订阅的钩子 :

```tsx
import { captureLaunchEvents } from '@capawesome/capacitor-react-hooks';
import { PushNotifications } from '@capacitor/push-notifications';

captureLaunchEvents([{ plugin: PushNotifications, event: 'pushNotificationActionPerformed' }]);

createRoot(document.getElementById('root')!).render(<App />);
```

## 覆盖的插件

| 子路径 | 插件 |
| --- | --- |
| `capacitor/action-sheet` | `@capacitor/action-sheet` |
| `capacitor/app-launcher` | `@capacitor/app-launcher` |
| `capacitor/app` | `@capacitor/app` |
| `capacitor/background-runner` | `@capacitor/background-runner` |
| `capacitor/barcode-scanner` | `@capacitor/barcode-scanner` |
| `capacitor/browser` | `@capacitor/browser` |
| `capacitor/calendar` | `@capacitor/calendar` |
| `capacitor/camera` | `@capacitor/camera` |
| `capacitor/clipboard` | `@capacitor/clipboard` |
| `capacitor/contacts` | `@capacitor/contacts` |
| `capacitor/device` | `@capacitor/device` |
| `capacitor/dialog` | `@capacitor/dialog` |
| `capacitor/file-transfer` | `@capacitor/file-transfer` |
| `capacitor/file-viewer` | `@capacitor/file-viewer` |
| `capacitor/filesystem` | `@capacitor/filesystem` |
| `capacitor/geolocation` | `@capacitor/geolocation` |
| `capacitor/google-maps` | `@capacitor/google-maps` |
| `capacitor/haptics` | `@capacitor/haptics` |
| `capacitor/inappbrowser` | `@capacitor/inappbrowser` |
| `capacitor/keyboard` | `@capacitor/keyboard` |
| `capacitor/local-notifications` | `@capacitor/local-notifications` |
| `capacitor/motion` | `@capacitor/motion` |
| `capacitor/network` | `@capacitor/network` |
| `capacitor/preferences` | `@capacitor/preferences` |
| `capacitor/privacy-screen` | `@capacitor/privacy-screen` |
| `capacitor/push-notifications` | `@capacitor/push-notifications` |
| `capacitor/screen-orientation` | `@capacitor/screen-orientation` |
| `capacitor/screen-reader` | `@capacitor/screen-reader` |
| `capacitor/share` | `@capacitor/share` |
| `capacitor/splash-screen` | `@capacitor/splash-screen` |
| `capacitor/status-bar` | `@capacitor/status-bar` |
| `capacitor/system-bars` | `@capacitor/core` (系统条API) |
| `capacitor/text-zoom` | `@capacitor/text-zoom` |
| `capacitor/toast` | `@capacitor/toast` |
| `capawesome/accelerometer` | `@capawesome-team/capacitor-accelerometer` |
| `capawesome/accessibility-preferences` | `@capawesome/capacitor-accessibility-preferences` |
| `capawesome/action-sheet` | `@capawesome/capacitor-action-sheet` |
| `capawesome/admob` | `@capawesome-team/capacitor-admob` |
| `capawesome/age-signals` | `@capawesome/capacitor-age-signals` |
| `capawesome/alarm` | `@capawesome/capacitor-alarm` |
| `capawesome/android-battery-optimization` | `@capawesome-team/capacitor-android-battery-optimization` |
| `capawesome/android-edge-to-edge-support` | `@capawesome/capacitor-android-edge-to-edge-support` |
| `capawesome/android-foreground-service` | `@capawesome-team/capacitor-android-foreground-service` |
| `capawesome/android-intent-launcher` | `@capawesome/capacitor-android-intent-launcher` |
| `capawesome/android-sms-retriever` | `@capawesome/capacitor-android-sms-retriever` |
| `capawesome/app-icon` | `@capawesome/capacitor-app-icon` |
| `capawesome/app-integrity` | `@capawesome/capacitor-app-integrity` |
| `capawesome/app-language` | `@capawesome/capacitor-app-language` |
| `capawesome/app-launcher` | `@capawesome/capacitor-app-launcher` |
| `capawesome/app-review` | `@capawesome/capacitor-app-review` |
| `capawesome/app-shortcuts` | `@capawesome/capacitor-app-shortcuts` |
| `capawesome/app-tracking-transparency` | `@capawesome/capacitor-app-tracking-transparency` |
| `capawesome/app-update` | `@capawesome/capacitor-app-update` |
| `capawesome/apple-sign-in` | `@capawesome/capacitor-apple-sign-in` |
| `capawesome/asset-manager` | `@capawesome/capacitor-asset-manager` |
| `capawesome/audio-player` | `@capawesome-team/capacitor-audio-player` |
| `capawesome/audio-recorder` | `@capawesome-team/capacitor-audio-recorder` |
| `capawesome/audio-session` | `@capawesome/capacitor-audio-session` |
| `capawesome/background-geolocation` | `@capawesome-team/capacitor-background-geolocation` |
| `capawesome/background-task` | `@capawesome/capacitor-background-task` |
| `capawesome/badge` | `@capawesome/capacitor-badge` |
| `capawesome/barcode-scanner` | `@capawesome-team/capacitor-barcode-scanner` |
| `capawesome/barometer` | `@capawesome-team/capacitor-barometer` |
| `capawesome/battery` | `@capawesome/capacitor-battery` |
| `capawesome/biometrics` | `@capawesome-team/capacitor-biometrics` |
| `capawesome/bluetooth-low-energy` | `@capawesome-team/capacitor-bluetooth-low-energy` |
| `capawesome/calendar` | `@capawesome-team/capacitor-calendar` |
| `capawesome/clipboard` | `@capawesome/capacitor-clipboard` |
| `capawesome/cloudinary` | `@capawesome/capacitor-cloudinary` |
| `capawesome/compass` | `@capawesome/capacitor-compass` |
| `capawesome/contacts` | `@capawesome-team/capacitor-contacts` |
| `capawesome/crisp` | `@capawesome/capacitor-crisp` |
| `capawesome/datetime-picker` | `@capawesome-team/capacitor-datetime-picker` |
| `capawesome/device-info` | `@capawesome/capacitor-device-info` |
| `capawesome/dialog` | `@capawesome/capacitor-dialog` |
| `capawesome/document-scanner` | `@capawesome-team/capacitor-document-scanner` |
| `capawesome/exif` | `@capawesome/capacitor-exif` |
| `capawesome/facebook-sign-in` | `@capawesome/capacitor-facebook-sign-in` |
| `capawesome/file-compressor` | `@capawesome-team/capacitor-file-compressor` |
| `capawesome/file-manager` | `@capawesome-team/capacitor-file-manager` |
| `capawesome/file-opener` | `@capawesome-team/capacitor-file-opener` |
| `capawesome/file-picker` | `@capawesome/capacitor-file-picker` |
| `capawesome/file-transfer` | `@capawesome-team/capacitor-file-transfer` |
| `capawesome/formbricks` | `@capawesome/capacitor-formbricks` |
| `capawesome/geocoder` | `@capawesome-team/capacitor-geocoder` |
| `capawesome/geofences` | `@capawesome-team/capacitor-geofences` |
| `capawesome/google-sign-in` | `@capawesome/capacitor-google-sign-in` |
| `capawesome/grafana-faro` | `@capawesome/capacitor-grafana-faro` |
| `capawesome/gyroscope` | `@capawesome/capacitor-gyroscope` |
| `capawesome/haptics` | `@capawesome/capacitor-haptics` |
| `capawesome/health` | `@capawesome-team/capacitor-health` |
| `capawesome/home-indicator` | `@capawesome/capacitor-home-indicator` |
| `capawesome/in-app-browser` | `@capawesome/capacitor-in-app-browser` |
| `capawesome/install-referrer` | `@capawesome/capacitor-install-referrer` |
| `capawesome/intercom` | `@capawesome/capacitor-intercom` |
| `capawesome/intune` | `@capawesome/capacitor-intune` |
| `capawesome/keep-awake` | `@capawesome/capacitor-keep-awake` |
| `capawesome/libsql` | `@capawesome/capacitor-libsql` |
| `capawesome/light-sensor` | `@capawesome/capacitor-light-sensor` |
| `capawesome/live-update` | `@capawesome/capacitor-live-update` |
| `capawesome/llm` | `@capawesome-team/capacitor-llm` |
| `capawesome/localization` | `@capawesome/capacitor-localization` |
| `capawesome/mail-composer` | `@capawesome/capacitor-mail-composer` |
| `capawesome/managed-configurations` | `@capawesome/capacitor-managed-configurations` |
| `capawesome/maplibre` | `@capawesome/capacitor-maplibre` |
| `capawesome/maps-launcher` | `@capawesome/capacitor-maps-launcher` |
| `capawesome/media-session` | `@capawesome-team/capacitor-media-session` |
| `capawesome/navigation-bar` | `@capawesome/capacitor-navigation-bar` |
| `capawesome/network` | `@capawesome/capacitor-network` |
| `capawesome/nfc` | `@capawesome-team/capacitor-nfc` |
| `capawesome/nodejs` | `@capawesome/capacitor-nodejs` |
| `capawesome/oauth` | `@capawesome-team/capacitor-oauth` |
| `capawesome/passkeys` | `@capawesome/capacitor-passkeys` |
| `capawesome/password-autofill` | `@capawesome/capacitor-password-autofill` |
| `capawesome/pdf-generator` | `@capawesome/capacitor-pdf-generator` |
| `capawesome/pdf-viewer` | `@capawesome/capacitor-pdf-viewer` |
| `capawesome/pedometer` | `@capawesome-team/capacitor-pedometer` |
| `capawesome/permissions` | `@capawesome/capacitor-permissions` |
| `capawesome/phone-dialer` | `@capawesome/capacitor-phone-dialer` |
| `capawesome/photo-editor` | `@capawesome/capacitor-photo-editor` |
| `capawesome/photo-manipulator` | `@capawesome/capacitor-photo-manipulator` |
| `capawesome/pixlive` | `@capawesome/capacitor-pixlive` |
| `capawesome/posthog` | `@capawesome/capacitor-posthog` |
| `capawesome/printer` | `@capawesome-team/capacitor-printer` |
| `capawesome/privacy-screen` | `@capawesome/capacitor-privacy-screen` |
| `capawesome/proximity-sensor` | `@capawesome/capacitor-proximity-sensor` |
| `capawesome/purchases` | `@capawesome-team/capacitor-purchases` |
| `capawesome/realtimekit` | `@capawesome/capacitor-realtimekit` |
| `capawesome/root-detection` | `@capawesome/capacitor-root-detection` |
| `capawesome/screen-brightness` | `@capawesome/capacitor-screen-brightness` |
| `capawesome/screen-orientation` | `@capawesome/capacitor-screen-orientation` |
| `capawesome/screen-reader` | `@capawesome/capacitor-screen-reader` |
| `capawesome/screenshot` | `@capawesome/capacitor-screenshot` |
| `capawesome/secure-preferences` | `@capawesome-team/capacitor-secure-preferences` |
| `capawesome/settings-launcher` | `@capawesome/capacitor-settings-launcher` |
| `capawesome/shake` | `@capawesome/capacitor-shake` |
| `capawesome/share-target` | `@capawesome-team/capacitor-share-target` |
| `capawesome/silent-mode` | `@capawesome/capacitor-silent-mode` |
| `capawesome/sim` | `@capawesome/capacitor-sim` |
| `capawesome/sms-composer` | `@capawesome/capacitor-sms-composer` |
| `capawesome/speech-recognition` | `@capawesome-team/capacitor-speech-recognition` |
| `capawesome/speech-synthesis` | `@capawesome-team/capacitor-speech-synthesis` |
| `capawesome/sqlite` | `@capawesome-team/capacitor-sqlite` |
| `capawesome/square-mobile-payments` | `@capawesome/capacitor-square-mobile-payments` |
| `capawesome/superwall` | `@capawesome/capacitor-superwall` |
| `capawesome/system-webview` | `@capawesome/capacitor-system-webview` |
| `capawesome/text-interaction` | `@capawesome/capacitor-text-interaction` |
| `capawesome/text-zoom` | `@capawesome/capacitor-text-zoom` |
| `capawesome/thermal-state` | `@capawesome/capacitor-thermal-state` |
| `capawesome/toast` | `@capawesome/capacitor-toast` |
| `capawesome/torch` | `@capawesome/capacitor-torch` |
| `capawesome/vault` | `@capawesome-team/capacitor-vault` |
| `capawesome/volume` | `@capawesome/capacitor-volume` |
| `capawesome/wallet` | `@capawesome/capacitor-wallet` |
| `capawesome/watch` | `@capawesome-team/capacitor-watch` |
| `capawesome/wifi` | `@capawesome-team/capacitor-wifi` |
| `capawesome/youtube-player` | `@capawesome/capacitor-youtube-player` |
| `capawesome/zip` | `@capawesome-team/capacitor-zip` |
| `firebase/analytics` | `@capacitor-firebase/analytics` |
| `firebase/app-check` | `@capacitor-firebase/app-check` |
| `firebase/app` | `@capacitor-firebase/app` |
| `firebase/authentication` | `@capacitor-firebase/authentication` |
| `firebase/crashlytics` | `@capacitor-firebase/crashlytics` |
| `firebase/firestore` | `@capacitor-firebase/firestore` |
| `firebase/functions` | `@capacitor-firebase/functions` |
| `firebase/messaging` | `@capacitor-firebase/messaging` |
| `firebase/performance` | `@capacitor-firebase/performance` |
| `firebase/remote-config` | `@capacitor-firebase/remote-config` |
| `firebase/storage` | `@capacitor-firebase/storage` |
| `mlkit/barcode-scanning` | `@capacitor-mlkit/barcode-scanning` |
| `mlkit/digital-ink-recognition` | `@capacitor-mlkit/digital-ink-recognition` |
| `mlkit/document-scanner` | `@capacitor-mlkit/document-scanner` |
| `mlkit/entity-extraction` | `@capacitor-mlkit/entity-extraction` |
| `mlkit/face-detection` | `@capacitor-mlkit/face-detection` |
| `mlkit/face-mesh-detection` | `@capacitor-mlkit/face-mesh-detection` |
| `mlkit/genai-image-description` | `@capacitor-mlkit/genai-image-description` |
| `mlkit/genai-prompt` | `@capacitor-mlkit/genai-prompt` |
| `mlkit/genai-proofreading` | `@capacitor-mlkit/genai-proofreading` |
| `mlkit/genai-rewriting` | `@capacitor-mlkit/genai-rewriting` |
| `mlkit/genai-speech-recognition` | `@capacitor-mlkit/genai-speech-recognition` |
| `mlkit/genai-summarization` | `@capacitor-mlkit/genai-summarization` |
| `mlkit/image-labeling` | `@capacitor-mlkit/image-labeling` |
| `mlkit/language-identification` | `@capacitor-mlkit/language-identification` |
| `mlkit/object-detection` | `@capacitor-mlkit/object-detection` |
| `mlkit/pose-detection` | `@capacitor-mlkit/pose-detection` |
| `mlkit/selfie-segmentation` | `@capacitor-mlkit/selfie-segmentation` |
| `mlkit/smart-reply` | `@capacitor-mlkit/smart-reply` |
| `mlkit/subject-segmentation` | `@capacitor-mlkit/subject-segmentation` |
| `mlkit/text-recognition` | `@capacitor-mlkit/text-recognition` |
| `mlkit/translation` | `@capacitor-mlkit/translation` |
|  |  |

覆盖 Capawesome, Capacitor Firebase 和 Capacit ML Kit 插件 家庭正在进行之中.

## 发展

```bash
npm install
npm run build
npm run test
npm run lint
```

这个 [`example`](https://npmcn.com/package/%40capawesome/capacitor-react-hooks/example) 应用程序练习每个钩 :

```bash
cd example
npm install
npm run dev
```

## 许可证

见 [自由主义](https://github.com/capawesome-team/capacitor-react-hooks/blob/main/LICENSE)。 。 。 .

## 常见问题

### @capawesome/capacitor-react-hooks 是什么？

电容插件的反应钩

### 如何安装 @capawesome/capacitor-react-hooks？

在项目目录运行 npm install @capawesome/capacitor-react-hooks，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@capacitor/core（\>=8\.0\.0）、react（^18\.0\.0 \|\| ^19\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @capawesome/capacitor-react-hooks 支持 TypeScript 吗？

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

### @capawesome/capacitor-react-hooks 支持 ESM 还是 CommonJS？

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

### @capawesome/capacitor-react-hooks 需要什么版本的 Node\.js？

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

### @capawesome/capacitor-react-hooks 可以商用吗？

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

### @capawesome/capacitor-react-hooks 的下载量有多少？

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

### @capawesome/capacitor-react-hooks 还在维护吗？

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