Zum Hauptinhalt springen
@capgo/capacitor-health Device-APIs Open Source

Status Capacitor Plugin

Greife auf Gesundheits- und Fitnessdaten nativer Gesundheitsplattformen zu

Installieren

bun add @capgo/capacitor-health bunx cap sync
npm, pnpm oder yarn
  • npm install @capgo/capacitor-health
  • pnpm add @capgo/capacitor-health
  • yarn add @capgo/capacitor-health

Anleitung

So nutzt du Health in Capacitor

@capgo/capacitor-health verwenden

Capacitor-Plugin zum Zugriff auf Daten aus Apple HealthKit und Health Connect.

Installieren

bun add @capgo/capacitor-health
bunx cap sync

bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.

Importieren

import { Health } from '@capgo/capacitor-health';

API auf einen Blick

Methode Beschreibung
isAvailable Gibt zurück, ob die aktuelle Plattform das native Health-SDK unterstützt.
requestAuthorization Fordert Lese-/Schreibzugriff auf die angegebenen Datentypen an.
checkAuthorization Prüft den Autorisierungsstatus für die angegebenen Datentypen, ohne den Nutzer zu fragen.
readSamples Liest Samples für den angegebenen Datentyp innerhalb des festgelegten Zeitraums aus.
saveSample Schreibt ein einzelnes Sample in den nativen Health Store.
openHealthConnectSettings Öffnet die Health Connect-Einstellungen (nur Android). Unter iOS bewirkt diese Methode nichts.
showPrivacyPolicy Zeigt die Datenschutzerklärung der App für Health Connect (nur Android). Unter iOS bewirkt diese Methode nichts.
queryWorkouts Ruft Trainingssitzungen aus dem nativen Health-Store ab. Unterstützt auf iOS (HealthKit) und Android (Health Connect).
queryAggregated Ruft aggregierte Gesundheitsdaten aus dem nativen Health-Store ab. Aggregiert Daten in Zeitintervallen (Stunde, Tag, Woche, Monat) mit Operationen wie Summe, Durchschnitt, Minimum oder Maximum. Dies ist effizienter als das Abrufen einzelner Samples für große Datumsbereiche.

Beispiele

isAvailable()

Gibt zurück, ob die aktuelle Plattform das native Health-SDK unterstützt.

import { Health } from '@capgo/capacitor-health';

const result = await Health.isAvailable();
console.log(result);

requestAuthorization()

Fordert Lese-/Schreibzugriff auf die angegebenen Datentypen an.

import { Health } from '@capgo/capacitor-health';

const result = await Health.requestAuthorization({ read: ['steps'] });
console.log(result);

checkAuthorization()

Prüft den Autorisierungsstatus für die angegebenen Datentypen, ohne den Nutzer zu fragen.

import { Health } from '@capgo/capacitor-health';

const result = await Health.checkAuthorization({ read: ['steps'] });
console.log(result);

readSamples()

Liest Samples für den angegebenen Datentyp innerhalb des festgelegten Zeitraums aus.

import { Health } from '@capgo/capacitor-health';

const result = await Health.readSamples({ dataType: 'steps' });
console.log(result);

saveSample()

Schreibt ein einzelnes Sample in den nativen Health Store.

import { Health } from '@capgo/capacitor-health';

await Health.saveSample({
  dataType: 'steps',
  value: 1,
});

openHealthConnectSettings()

Öffnet die Health Connect-Einstellungen (nur Android). Unter iOS bewirkt diese Methode nichts.

import { Health } from '@capgo/capacitor-health';

await Health.openHealthConnectSettings();

Die obige Tabelle listet die 9 Kernmethoden auf. Listener- und Versions-Helper sowie der vollständige Contract jeder Methode sind in der GitHub Repository.

Vollständige Referenz

Weiter mit der Verwendung von @capgo/capacitor-health

Wenn du es nutzt @capgo/capacitor-health verwenden Um die Arbeit an nativen Plugins zu planen, verbinde sie mit @capgo/capacitor-health für die Implementierungsdetails in @capgo/capacitor-health, Erste Schritte für die Implementierungsdetails in Erste Schritte, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für die Implementierungsdetails in Capacitor Plugins von Capgo, und Plugins hinzufügen oder aktualisieren für die Implementierungsdetails in Plugins hinzufügen oder aktualisieren.

FAQ

FAQ zum Health-Plugin

Wie installiere ich das Health-Plugin in einer Capacitor-App?

Führe "bun add @capgo/capacitor-health" (oder "npm install @capgo/capacitor-health") aus und dann "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deinem App-code aus "@capgo/capacitor-health".

Funktioniert @capgo/capacitor-health mit React, Vue und Angular?

Ja. Health ist ein Capacitor-Paket und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor-Version unterstützt @capgo/capacitor-health?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-health kostenlos und Open Source?

Ja. Der Quell-code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-health/ verfügbar und das Paket kann kostenlos von npm installiert werden. Bug-Reports und Pull Requests sind willkommen.

Kann ich code aktualisieren, das Health verwendet, ohne eine App-Store-Prüfung?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

Health-Änderungen veröffentlichen, ohne auf die App-Prüfung zu warten

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo