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-, Speicher-, GPU-, Speicherplatz-, Thermal-, Low-Power- und Onboard-Sensormetriken aus einer Capacitor App auslesen.

Kompatibilität

Dieses Plugin benötigt Capacitor 8 oder höher (@capacitor/core >=8.0.0).

Installieren

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

Funktionen dieses Plugins

  • getInfo - Einen Snapshot mit CPU, Speicher, GPU, Speicherplatz, thermischem Status, Stromsparmodus und Onboard-Sensoren lesen.
  • startMonitoring - Periodische Snapshots für Charts und Diagnose-Dashboards starten.
  • stopMonitoring - Den aktiven Stream stoppen.
  • isMonitoring - Stream-Status und Anzahl der emittierten Samples prüfen.
  • removeAllListeners - Alle beim Plugin registrierten Listener entfernen.
  • deviceInfoUpdate - Listener-Event, das bei jedem periodischen Sample emittiert wird.

Anwendungsbeispiel

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 Chart 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();

Das Monitoring nutzt standardmäßig ein 1000 ms Intervall, begrenzt Intervalle auf mindestens 250 ms und emittiert sofort ein Sample, sofern Sie nicht emitImmediately: false. Der Aufruf von startMonitoring() startet die aktive Session mit den neuen Optionen neu. Jedes Event enthält seine sequence, startedAt, und elapsedMs.

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

Onboard-Sensornotizen

Sensor-Messwerte sind optional, da Geräte unterschiedliche Hardware nutzen. Android kann Batterietemperatur, Umgebungstemperatur, Luftfeuchtigkeit, Luftdruck, Licht, Annäherung und (sofern verfügbar) CPU/GPU-Thermal-Zone-Werte liefern. iOS meldet die Verfügbarkeit von CoreMotion-Sensoren, den Thermal State und den Low-Power-Status, aber öffentliche iOS-APIs geben keine Rohdaten der CPU- oder GPU-Temperatur preis.

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

Vollständige Referenz

Weiter

Wenn du es nutzt @capgo/capacitor-device-info um Diagnose- oder Monitoring-Screens zu bauen, 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 Pressure-Streaming, und @capgo/capacitor-light-sensor verwenden für präzise Lichtmessungen.

FAQ

Device Info Plugin FAQ

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 danach "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deiner code App aus "@capgo/capacitor-device-info".

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

Ja. Device Info ist ein Capacitor Package 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 wird von @capgo/capacitor-device-info unterstützt?

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 code Source Code ist auf GitHub unter https://github.com/Cap-go/capacitor-device-info/ öffentlich einsehbar und das Package kann kostenlos via npm installiert werden. Bug-Reports und Pull Requests sind willkommen.

Kann ich code mit Device Info nutzen, ohne ein App Store Review abzuwarten?

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 den 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