Endpunkte

Vorbereitung für die Stores

Was eine App für Google Play und den App Store noch braucht, und die Schritte der Reihe nach.

GEThttps://www.setherion.com/api/v1/projects/{id}/store

Tarif: Jeder Tarif

Das Fenster „Publish to app stores“ des Editors, als Daten ausgedrückt: was für die Stores bereit ist und, mit way, die Schritte für Android und iPhone der Reihe nach. Es liest den gespeicherten Code der App mit denselben Hilfsfunktionen wie das Fenster und widerspricht ihm deshalb nie.

Es ist kostenlos und verbraucht keine Credits. Der Zugriff als Viewer genügt. Zu den Fenstern und der vollständigen Anleitung siehe In App Stores veröffentlichen.

Anfrage

Ohne way, um zuerst die beiden Wege zu vergleichen:

bash
curl https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/store \
  -H "Authorization: Bearer $SETHERION_API_KEY"

Mit way, für die Schritte:

bash
curl "https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/store?way=easy" \
  -H "Authorization: Bearer $SETHERION_API_KEY"
ParameterBedeutung
wayOptional. easy oder native. easy verpackt die veröffentlichte Website mit PWA Builder in Store-Pakete, ohne Code. native ist die ganze App als Handy-Projekt, das der Owner auf einem Computer erstellt, nötig für Werbung und In-App-Käufe. Alles andere beantwortet 400.

Die App muss Code haben. Ist sie veröffentlicht, fragt der Aufruf außerdem die Live-App nach ihrem Store-Symbol (/icon-512.png) und wartet dafür höchstens 5 Sekunden.

Antwort ohne way

json
{
  "ok": true,
  "app": { "name": "Coffee shop", "url": "https://coffee-shop.setherion.app" },
  "ready": [
    {
      "item": "Published on the web",
      "state": "ok",
      "note": "https://coffee-shop.setherion.app"
    },
    {
      "item": "Store icon",
      "state": "ok",
      "note": "PNG in every size the stores ask for, made when the app is published."
    },
    {
      "item": "Privacy policy page",
      "state": "missing",
      "note": "Both stores ask for a link to one, and none was found in this app.",
      "fix": "Add a Privacy Policy page at /privacy, linked from the footer and from the sign-up screen. Say what the app keeps (the account email and what people enter), why, for how long, that nothing is sold, and how to ask for an account and its data to be deleted. Leave the owner's contact email as a placeholder to fill in."
    }
  ],
  "ways": {
    "easy": "Easy, no code: PWA Builder wraps the published website into store packages. About 2 steps in Setherion, the rest in the stores. Android is done from any computer; iPhone needs a Mac with Xcode.",
    "native": "Native, for developers: the whole app as a phone project (Capacitor). Needed for ads and in-app purchases. Built on the owner's computer (Android Studio; a Mac with Xcode for iPhone), or in the cloud by GitHub when pushed to GitHub: no Android Studio and no Mac."
  },
  "onlyInSetherion": "In Setherion: open the app, Publish, then \"Publish to app stores\". Only there: dropping PWA Builder's ZIP, adding Google Play's key, downloading the phone project or pushing it to GitHub, the store screenshots (every size both stores ask for, free), and the store guidelines check. The window ticks the steps it can see, and keeps the owner's own ticks."
}
FeldTypBedeutung
appobjectDer name der App und ihre url, oder null, wenn sie nicht veröffentlicht ist.
readylistWas bereit ist und was fehlt. Siehe unten.
waysobjectEin Satz für jeden Weg, easy und native.
onlyInSetherionstringWas nur das Fenster in Setherion kann, damit ein Programm weiß, wo seine Reichweite endet.

Die Liste ready

Jeder Eintrag hat item, state und note, manchmal auch fix.

FeldBedeutung
itemWas geprüft wird.
stateok, missing oder unknown, wenn es gerade nicht geprüft werden konnte.
noteEin Satz, der sagt, warum.
fixNur bei einem Eintrag mit missing, den der Editor hinzufügen kann. Der Text, den Sie als prompt an Eine App ändern senden, sobald der Owner zustimmt, denn eine Änderung kostet Credits.
Die Einträge, die erscheinen können
  • Published on the web. ok, wenn die App eine Adresse hat. missing, wenn nicht: Der Weg Easy verpackt die veröffentlichte Adresse, veröffentlichen Sie also zuerst. Der Weg Native funktioniert auch ohne.
  • Store icon. Wird erst aufgeführt, wenn die App veröffentlicht ist. ok, wenn die Live-App das PNG-Symbol ausliefert, missing, wenn nicht (veröffentlichen Sie erneut; eine App auf einer eigenen Domain hat vorerst nur das SVG-Symbol), unknown, wenn die Live-App nicht geprüft werden konnte.
  • Delete account button. Wird nur aufgeführt, wenn sich Menschen bei der App anmelden können. Apple lehnt eine solche App ohne ihn ab. missing hat ein fix.
  • Privacy policy page. Beide Stores verlangen einen Link dazu. missing hat ein fix.

Antwort mit way

Dieselben Felder und die Schritte für den Weg, nach dem Sie gefragt haben:

json
{
  "ok": true,
  "app": { "name": "Coffee shop", "url": "https://coffee-shop.setherion.app" },
  "ready": [ "... as above ..." ],
  "ways": { "easy": "...", "native": "..." },
  "way": "easy",
  "android": [
    {
      "step": 1,
      "title": "Make the Android package",
      "meta": "PWA Builder, about 2 minutes",
      "detail": "Open PWA Builder with the app's address filled in. Choose Package for stores, then Android, and download the ZIP.",
      "link": "https://www.pwabuilder.com/reportcard?site=https%3A%2F%2Fcoffee-shop.setherion.app"
    },
    {
      "step": 2,
      "title": "Link the app to your site",
      "meta": "So it opens without a browser's address bar",
      "detail": "In Setherion: open the app, Publish, then \"Publish to app stores\", Easy, Android, this step: drop the ZIP from PWA Builder there. ...",
      "done": false
    }
  ],
  "iphone": [ "... five steps, numbered the same way ..." ],
  "iphoneNotes": [
    "A Mac is needed. The Easy way builds the iPhone app on a Mac with Xcode. The Native way can build it on GitHub's Mac computers instead. Make sure you have one of the two before you pay Apple's $99 a year.",
    "To Apple this looks like a website. Nobody signs in, nothing is saved, and Apple turns down apps that are only a website (guideline 4.2). Sign-in, saved data and features people come back to make it an app. Run the store guidelines check on the first page before you send it."
  ],
  "onlyInSetherion": "..."
}

(Hier gekürzt: Die echte Antwort enthält jeden Schritt vollständig.)

FeldTypBedeutung
waystringDer gewünschte Weg, easy oder native.
androidlistDie Android-Schritte der Reihe nach.
iphonelistDie iPhone-Schritte der Reihe nach.
iphoneNoteslist of stringsWofür Apple die App ablehnen kann, jeweils ein Satz, mit dem Titel, den das Fenster dafür verwendet.

Jeder Schritt hat:

FeldTypBedeutung
stepnumberSein Platz in der Liste, ab 1.
titlestringDer Name des Schritts, so wie ihn das Fenster zeigt.
metastringEine kurze Zeile: wie lange es dauert, was es braucht oder was es kostet.
detailstringWas zu tun ist. Kann mehrere Zeilen enthalten, etwa die auszuführenden Befehle.
linkstringWo Sie es tun, wenn es einen Ort gibt. Sonst weggelassen.
donebooleanNur bei Schritten, die Setherion beim Weg Easy für Android selbst sehen kann: der Link zu Ihrer Website und der Schlüssel von Google Play. Weggelassen, wenn es das nicht sagen kann.
Die Schritte jeder Liste

Easy, Android: das Android-Paket erstellen, die App mit Ihrer Website verknüpfen, ein Google-Play-Entwicklerkonto eröffnen, es hochladen und testen, den Schlüssel von Google Play hinzufügen, die Store-Seite ausfüllen und veröffentlichen.

Easy, iPhone: ein Apple-Entwicklerkonto eröffnen, das iPhone-Paket erstellen, es bauen und hochladen, es auf Ihrem iPhone ausprobieren, die Store-Seite ausfüllen und zur Prüfung senden.

Native, Android: das Projekt herunterladen, bauen, signieren, hochladen und testen, veröffentlichen.

Native, iPhone: das Projekt herunterladen, bauen, signieren und hochladen, es auf Ihrem iPhone ausprobieren, die Store-Seite ausfüllen und zur Prüfung senden.

Beim Weg Native enthalten die Befehle in detail den zusätzlichen Einrichtungsschritt, wenn die App Werbung zeigt oder etwas verkauft, sowie die Hinweise zu Werbung und In-App-Käufen für die Store-Formulare.

Fehler

StatusWann
400way ist etwas anderes als easy oder native.
401Der Schlüssel fehlt, ist falsch oder wurde widerrufen.
404Es gibt keine solche App, oder Ihr Schlüssel kann sie nicht öffnen.
409Die App hat noch keinen Code. Erstellen Sie sie zuerst in Setherion.
Die genauen Sätze
Statuserror
400way is "easy" or "native".
404No such app on this account.
409This app has no code yet. Build it in Setherion first.

War diese Seite hilfreich?

Der Community beitreten

Fragen, Ideen und was andere erstellen.