Salta al contenuto principale
@capgo/capacitor-health API del dispositivo Open source

Health plugin Capacitor

Accedi ai dati di salute e fitness dalle piattaforme native

Installa

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

Guida

Come usare Health in Capacitor

Usare @capgo/capacitor-health

Plugin Capacitor per interagire con i dati di Apple HealthKit e Health Connect.

Installa

bun add @capgo/capacitor-health
bunx cap sync

bunx cap sync copia il code nativo del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.

Importa

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

API in breve

Metodo Descrizione
isAvailable Restituisce se la piattaforma corrente supporta il SDK nativo della salute.
requestAuthorization Richiede l'accesso in lettura/scrittura ai tipi di dati forniti.
checkAuthorization Verifica lo stato di autorizzazione per i tipi di dati forniti senza mostrare prompt all'utente.
readSamples Legge i campioni per il tipo di dato specificato nell'intervallo di tempo indicato.
saveSample Scrive un singolo campione nel database nativo della salute.
openHealthConnectSettings Apre la schermata delle impostazioni di Health Connect (solo Android). Su iOS, questo metodo non fa nulla.
showPrivacyPolicy Mostra l'informativa sulla privacy dell'app per Health Connect (solo Android). Su iOS, questo metodo non fa nulla.
queryWorkouts Interroga le sessioni di allenamento dal database nativo della salute. Supportato su iOS (HealthKit) e Android (Health Connect).
queryAggregated Interroga i dati sanitari aggregati dal database nativo. Aggrega i dati in intervalli temporali (ora, giorno, settimana, mese) con operazioni come somma, media, min o max. È più efficiente che recuperare singoli campioni per lunghi intervalli di date.

Esempi

isAvailable()

Restituisce se la piattaforma corrente supporta il SDK nativo della salute.

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

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

requestAuthorization()

Richiede l'accesso in lettura/scrittura ai tipi di dati forniti.

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

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

checkAuthorization()

Verifica lo stato di autorizzazione per i tipi di dati forniti senza mostrare prompt all'utente.

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

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

readSamples()

Legge i campioni per il tipo di dato specificato nell'intervallo di tempo indicato.

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

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

saveSample()

Scrive un singolo campione nel database nativo della salute.

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

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

openHealthConnectSettings()

Apre la schermata delle impostazioni di Health Connect (solo Android). Su iOS, questo metodo non fa nulla.

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

await Health.openHealthConnectSettings();

La tabella sopra elenca i 9 metodi principali. Listener, helper di versione e il contratto completo di ogni metodo sono documentati nel repository GitHub.

Riferimento completo

Continua da Usare @capgo/capacitor-health

Se stai usando Usare @capgo/capacitor-health per pianificare il lavoro sui plugin nativi, connettilo a @capgo/capacitor-health per i dettagli di implementazione in @capgo/capacitor-health, Per iniziare per i dettagli di implementazione in Getting Started, Directory Plugin Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Plugin Capacitor di Capgo, e Aggiunta o aggiornamento dei plugin per i dettagli di implementazione in Aggiunta o aggiornamento dei plugin.

FAQ

FAQ sul plugin Health

Come installo il plugin Health in un'app Capacitor?

Esegui "bun add @capgo/capacitor-health" (o "npm install @capgo/capacitor-health"), poi lancia "bunx cap sync" in modo che i progetti iOS e Android integrino il code nativo. Importalo da "@capgo/capacitor-health" nel code della tua app.

@capgo/capacitor-health funziona con React, Vue e Angular?

Sì. Health è un pacchetto Capacitor, quindi funziona con qualsiasi web framework in esecuzione all'interno di Capacitor, inclusi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor è supportata da @capgo/capacitor-health?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

@capgo/capacitor-health è free e open source?

Sì. Il codice sorgente code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-health/ e il pacchetto è gratuito su npm. Bug report e pull request sono i benvenuti.

Posso aggiornare code che usa Health senza passare per la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Rilascia modifiche alla Health senza attendere la revisione dell'app

Una volta che il plugin è nel tuo store build, Capgo live updates invia le modifiche a JavaScript, HTML e CSS agli utenti in pochi minuti.

Inizia con Capgo