Docs

Loslegen

Schnellstart: deine erste Freischaltung

In etwa 15 Minuten kaufst du deine eigene App auf deiner eigenen Uhr, siehst die Freischaltung, erstattest sie dann und siehst, wie sie sich wieder sperrt. Alles läuft im Testmodus: Es ist kostenlos und es fließt kein Geld.

Bevor du anfängst

  • Ein Connect IQ-Projekt, das sich bauen lässt. Diese Seite zeigt eine App. Zifferblätter und Datenfelder brauchen statt einer Zeile ein paar Hooks: siehe Zifferblätter und Datenfelder.
  • Eine Uhr oder der Connect IQ-Simulator.
  • Ein Handy mit Kamera.
  • Ein Stripe-, PayPal-, Polar-, Razorpay- oder Paystack-Konto. Du kannst es beim Verbinden anlegen.

Die App im Dashboard einrichten

  1. Füge deine App hinzu. Öffne App hinzufügen. Gib ihr einen Namen, sag, was sie ist (App, Zifferblatt oder Datenfeld), füge ein Symbol hinzu und wähle ihre Farbe.
  2. Leg fest, was kostet. Wähle die ganze App oder einzelne Funktionen und schreib bis zu drei kurze Zeilen dazu, was Premium bietet. Lass für diesen ersten Test die kostenlose Testphase bei 0 Tagen, damit der Kaufbildschirm sofort erscheint. Eine Testphase kannst du später hinzufügen.
  3. Verbinde ein Testzahlungskonto. Wähle im Schritt Zahlungen verbinden Stripe verbinden oder PayPal verbinden und verbinde den Testbereich. Live folgt beim Livegang. Käufer zahlen direkt auf dieses Konto: Wir halten nie das Geld.
  4. Leg einen Preis fest. Einmalig, als Abo oder für eine feste Zeit. Du kannst ihn später ändern.

Bibliothek zum Projekt hinzufügen

Der letzte Schritt, Zu deiner App hinzufügen, zeigt dieselben Zeilen mit den Daten deiner App. Du kannst ihn jederzeit im Tab Installieren der App wieder öffnen.

  1. Lade deine Konfiguration herunter. Lade PaywallConfig.mc in den Ordner source deines Projekts. Sie enthält die Adresse deiner App. Sie ist öffentlich, kein Geheimnis.
  2. Füge die Bibliothek hinzu. Lade die Bibliothek herunter und entpacke sie neben dem Ordner deiner App, sodass beide nebeneinander liegen.
  3. Verweise deine jungle-Datei darauf. Füge die Ordner der Bibliothek mit relativen Pfaden zu monkey.jungle hinzu.
  4. Erlaube das Netzwerk. Füge deinem Manifest die Berechtigung Communications hinzu.
monkey.jungle
base.sourcePath = source;../wearcheckout/lib/watch/app;../wearcheckout/lib/watch/glance
base.resourcePath = resources;../wearcheckout/lib/watch/resources
manifest.xml
<iq:permissions>
    <iq:uses-permission id="Communications"/>
</iq:permissions>

Deine Konfigurationsdatei sieht so aus, mit der Adresse deiner eigenen App:

source/PaywallConfig.mc
// PaywallConfig.mc: from your dashboard (Interval Timer). Public, not a secret.
import Toybox.Lang;

(:glance)
module PaywallConfig {
    const URL = "https://pay.example/api/K7Q2/c";   // your app's address
    // const TRIAL_DAYS = 7;   // add for a time trial
}

Eine Zeile ändern

Verpacke in getInitialView() deiner App die Ansichten, die du schon zurückgibst:

source/YourApp.mc
// Before
return [new MainView(), new MainDelegate()];

// After: the whole app is paid for
return Paywall.gate([new MainView(), new MainDelegate()]);

Solange die App gesperrt ist, steht der Kaufbildschirm an ihrer Stelle. Nach dem Bezahlen öffnen sich deine eigenen Ansichten. Um nur einzelne Funktionen zu verkaufen, nutze Paywall.start und eine Prüfung pro Funktion: siehe Bezahlte Funktionen sperren.

Kauf sie auf deiner Uhr

  1. Starte sie. Baue die App und starte sie auf deiner Uhr oder im Simulator. Ihr erster Start registriert sie als deine Testuhr, und der Test-Tab der App hakt den ersten Schritt ab.
  2. Scanne den Code. Der Kaufbildschirm zeigt einen QR-Code. Richte die Kamera deines Handys darauf. Die Bezahlseite deines Zahlungsanbieters öffnet sich auf dem Handy, schon mit dieser Uhr verknüpft.
  3. Zahl mit der Testkarte. Bei Stripe nutzt du 4242 4242 4242 4242, ein beliebiges künftiges Datum und eine beliebige Prüfziffer. Bei PayPal nutzt du ein Käuferkonto aus deiner PayPal-Sandbox. Es fließt kein Geld.
  4. Sieh zu, wie sie freischaltet. Lass die App auf der Uhr offen. Etwa eine Sekunde nach der Zahlung spielt die Uhr die Freischaltung ab, mit Ton und Vibration, falls an der Uhr eingeschaltet, und zeigt „Premium aktiv“.
  5. Erstatte sie. Lass „Premium aktiv“ auf der Uhr stehen. Erstatte die Testzahlung im Test-Dashboard deines Zahlungsanbieters. Die Uhr sperrt sich binnen Sekunden wieder und zeigt den QR-Code.

Schon START oder BACK gedrückt? Dann ist der Kaufbildschirm zu, und die Uhr sperrt sich stattdessen bei ihrer nächsten Prüfung. Erstattungen, Anfechtungen und Verlängerungen sagt, wann das ist.

Den Test prüfen

Der Test-Tab der App hakt jeden dieser fünf Schritte ab, sobald er passiert:

  1. Deine Testuhr wurde registriert.
  2. Die Kaufseite auf einem Handy geöffnet.
  3. Die Testzahlung ging durch.
  4. Die Uhr wurde freigeschaltet.
  5. Eine Erstattung hat sie wieder gesperrt.

Dass alle fünf bestehen, ist eine der Prüfungen vor dem Livegang.

Nächste Schritte

Esc