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

Geräte-Info Capacitor Plugin

CPU-, Arbeitsspeicher-, GPU-, Speicherplatz-, Thermal- und Onboard-Sensor-Metriken aus Capacitor Apps auslesen

Installieren

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

Anleitung

Device Info in Capacitor nutzen

Verwendung von @capgo/capacitor-device-info

CPU-, Arbeitsspeicher-, GPU-, Speicherplatz-, Thermal-, Low-Power- und Onboard-Sensormetriken aus einer Capacitor-App auslesen.

Kompatibilität

Dieses Plugin erfordert Capacitor 8 oder neuer (@capacitor/core >=8.0.0).

Installieren

npm install @capgo/capacitor-device-info
npx cap sync

Was dieses Plugin bereitstellt

  • getInfo - Einmalig einen Snapshot mit CPU, Speicher, GPU, Speicherplatz, thermischem Zustand, Energiesparmodus und eingebauten Sensoren lesen.
  • startMonitoring - Periodische Snapshots für Diagramme und Diagnose-Dashboards starten.
  • stopMonitoring - Den aktiven Stream stoppen.
  • isMonitoring - Stream-Status und Anzahl der ausgegebenen Samples prüfen.
  • removeAllListeners - Alle auf dem Plugin registrierten Listener entfernen.
  • deviceInfoUpdate - Listener-Event, das für jedes periodische Sample ausgegeben wird.

Beispielhafte Verwendung

import { DeviceInfo } from '@capgo/capacitor-device-info';

const snapshot = await DeviceInfo.getInfo();

console.log(snapshot.cpu.cores);
console.log(snapshot.memory.usedPercent);
console.log(snapshot.gpu?.renderer);
console.log(snapshot.sensors?.pressureHpa);

Metriken in ein Diagramm streamen

import { DeviceInfo } from '@capgo/capacitor-device-info';

const samples: number[] = [];

const handle = await DeviceInfo.addListener('deviceInfoUpdate', (sample) => {
  if (typeof sample.cpu.usagePercent === 'number') {
    samples.push(sample.cpu.usagePercent);
  }
});

await DeviceInfo.startMonitoring({
  intervalMs: 1000,
  emitImmediately: true,
});

// Later:
await DeviceInfo.stopMonitoring();
await handle.remove();

Monitoring läuft standardmäßig in 1000-ms-Intervallen, begrenzt Intervalle unter 250 ms und gibt sofort ein Sample aus, es sei denn, Sie setzen emitImmediately: false. Der Aufruf von startMonitoring() startet die aktive Sitzung mit den neuen Optionen neu. Jedes Event enthält seine sequence, startedAt, und elapsedMs.

Nutzt durationMs oder sampleCount automatisch zu stoppen. Wenn du keinen Listener mehr brauchst, rufe await DeviceInfo.removeAllListeners().

Hinweise zu Onboard-Sensoren

Sensorwerte sind optional, da Geräte unterschiedliche Hardware bereitstellen. Android kann Batterietemperatur, Umgebungstemperatur, Luftfeuchtigkeit, Luftdruck, Licht, Näherung und – wenn verfügbar – CPU-/GPU-Thermalzonenwerte im Best-Effort-Verfahren melden. iOS meldet die Verfügbarkeit von CoreMotion-Sensoren, den thermischen Zustand und den Energiesparmodus, aber öffentliche iOS-APIs stellen keine rohen CPU- oder GPU-Temperaturen bereit.

Das Plugin ruft keine Wetterdaten ab. Außentemperatur und Luftfeuchtigkeit erfordern eine separate Integration für Standort und Wetter API.

Vollständige Referenz

Weiter

Wenn du es nutzt @capgo/capacitor-device-info um Diagnose- oder Monitoring-Screens zu erstellen, verbinde es mit @capgo/capacitor-device-info für die Übersicht, Erste Schritte für Installations- und API-Beispiele, @capgo/capacitor-barometer verwenden für dediziertes Druck-Streaming und @capgo/capacitor-light-sensor verwenden für dedizierte Lichtmessungen.

FAQ

FAQ zum Device Info Plugin

Wie installiere ich das Device Info Plugin in einer Capacitor-App?

Führe "bun add @capgo/capacitor-device-info" (oder "npm install @capgo/capacitor-device-info") aus und starte danach "bunx cap sync", damit die iOS- und Android-Projekte das native code übernehmen. Importiere es aus "@capgo/capacitor-device-info" in deinem App-code.

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

Ja. Device Info 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-device-info?

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-device-info kostenlos und Open Source?

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

Kann ich code ohne App-Store-Review aktualisieren, wenn Device Info im Einsatz ist?

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.

Device-Info-Änderungen ausrollen, ohne auf das App-Review 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