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.
https://www.setherion.com/api/v1/projects/{id}/storeTarif: 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:
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:
curl "https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/store?way=easy" \
-H "Authorization: Bearer $SETHERION_API_KEY"| Parameter | Bedeutung |
|---|---|
way | Optional. 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
{
"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."
}| Feld | Typ | Bedeutung |
|---|---|---|
app | object | Der name der App und ihre url, oder null, wenn sie nicht veröffentlicht ist. |
ready | list | Was bereit ist und was fehlt. Siehe unten. |
ways | object | Ein Satz für jeden Weg, easy und native. |
onlyInSetherion | string | Was 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.
| Feld | Bedeutung |
|---|---|
item | Was geprüft wird. |
state | ok, missing oder unknown, wenn es gerade nicht geprüft werden konnte. |
note | Ein Satz, der sagt, warum. |
fix | Nur 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.
missinghat einfix. - Privacy policy page. Beide Stores verlangen einen Link dazu.
missinghat einfix.
Antwort mit way
Dieselben Felder und die Schritte für den Weg, nach dem Sie gefragt haben:
{
"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.)
| Feld | Typ | Bedeutung |
|---|---|---|
way | string | Der gewünschte Weg, easy oder native. |
android | list | Die Android-Schritte der Reihe nach. |
iphone | list | Die iPhone-Schritte der Reihe nach. |
iphoneNotes | list of strings | Wofür Apple die App ablehnen kann, jeweils ein Satz, mit dem Titel, den das Fenster dafür verwendet. |
Jeder Schritt hat:
| Feld | Typ | Bedeutung |
|---|---|---|
step | number | Sein Platz in der Liste, ab 1. |
title | string | Der Name des Schritts, so wie ihn das Fenster zeigt. |
meta | string | Eine kurze Zeile: wie lange es dauert, was es braucht oder was es kostet. |
detail | string | Was zu tun ist. Kann mehrere Zeilen enthalten, etwa die auszuführenden Befehle. |
link | string | Wo Sie es tun, wenn es einen Ort gibt. Sonst weggelassen. |
done | boolean | Nur 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
| Status | Wann |
|---|---|
400 | way ist etwas anderes als easy oder native. |
401 | Der Schlüssel fehlt, ist falsch oder wurde widerrufen. |
404 | Es gibt keine solche App, oder Ihr Schlüssel kann sie nicht öffnen. |
409 | Die App hat noch keinen Code. Erstellen Sie sie zuerst in Setherion. |
Die genauen Sätze
| Status | error |
|---|---|
400 | way is "easy" or "native". |
404 | No such app on this account. |
409 | This app has no code yet. Build it in Setherion first. |
War diese Seite hilfreich?
