Für Entwickler

Deine erste Julianverse-App

Registriere eine Browser-App und starte mit der statischen Vorlage samt Anmeldung und optionalem Sync.

Was du bekommst#

Julianverse Account stellt die Anmeldung und eine auf freigegebene Datenarten begrenzte Sync-API bereit. Deine App bleibt selbst gehostet. Die herunterladbare Vorlage enthält HTML, CSS und Browser-Module sowie einen lokalen JSON-Editor. Sie benötigt für die Auslieferung keinen Build und kein Client-Secret.

Registrieren und ausprobieren#

  1. Melde dich mit bestätigter E-Mail im Account an und öffne Meine Apps.
  2. Lege eine App an. Für einen lokalen Test kannst du im Testmodus zum Beispiel http://localhost:8000/ mit dem Callback http://localhost:8000/account-callback.html eintragen.
  3. Definiere eine Datenart, zum Beispiel notes, und aktiviere sie.
  4. Lade die statische Vorlage herunter. Entpacke den Inhalt so, dass die registrierten Pfade im Webroot passen.
  5. Liefere die Dateien mit deinem vorhandenen Webserver aus. Für einen ausschließlich lokalen Versuch ist auch ein statischer Server möglich.
  6. Öffne die registrierte App-Adresse und probiere den JSON-Editor zunächst ohne Anmeldung aus.
  7. Melde dich über das Account-Panel an, gib notes im Account frei und wähle in der App ausdrücklich eine erste Übertragung.

Wenn dein Nginx bereits die richtige Domain und den Webroot ausliefert, brauchst du keinen zusätzlichen App-Server für diese Vorlage.

Die eigene Oberfläche einbauen#

Ersetze den JSON-Editor der Vorlage durch deine Oberfläche. Der SDK-Adapter speichert zuerst lokal und informiert das Account-Panel über Änderungen. Reagiere auf Cloud-Importe, damit deine Oberfläche die übernommenen Inhalte anzeigt.

Verwende config.app als App-ID beziehungsweise Ordnerkennung. config.clientId ist die OAuth-Client-ID; die beiden Werte haben unterschiedliche Aufgaben.

Mit anderen teilen#

Stelle die veröffentlichte App auf HTTPS um und registriere die exakten HTTPS-Adressen. Wähle Per Link teilbar und schalte den Testmodus aus. Solange die App privat ist oder im Testmodus läuft, kann sich nur der Ersteller anmelden.

Jeder Nutzer gibt seine eigenen Datenarten frei und verwendet seine eigene Cloud-Quota. Der Ersteller erhält durch die Registrierung keinen allgemeinen Zugriff auf die Dateien anderer Nutzer.

Den vollständigen Ablauf prüfen#

Teste lokale Nutzung, Anmeldung, Freigabe, erste Übertragung, erneutes Laden, Offline-Änderung, einen Konflikt auf zwei Geräten und Abmelden. Bei geänderten Callback- oder Zugriffsregeln musst du bestehende Zugänge neu erteilen.

Weiter geht es mit App-Registrierung, OAuth 2.0 und OIDC und der Sync-API.

Markdown herunterladen