Endpointuri

Pregătirea pentru magazine

Ce mai are nevoie o aplicație pentru Google Play și App Store și pașii, în ordine.

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

Plan: Orice plan

Fereastra „Publish to app stores” din editor, spusă în date: ce este pregătit pentru magazine și, cu way, pașii pentru Android și iPhone, în ordine. Citește codul salvat al aplicației cu aceleași funcții ajutătoare ca fereastra, deci nu o contrazice niciodată.

Este gratuit și nu folosește credite. Accesul de vizualizare este de ajuns. Pentru ferestre și pentru ghidul complet, vezi Publică în magazinele de aplicații.

Cererea

Fără way, ca să le compari mai întâi pe cele două căi:

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

Cu way, pentru pași:

bash
curl "https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/store?way=easy" \
  -H "Authorization: Bearer $SETHERION_API_KEY"
ParametruCe înseamnă
wayOpțional. easy sau native. easy împachetează site-ul publicat în pachete pentru magazine cu PWA Builder, fără cod. native este întreaga aplicație ca proiect de telefon pe care proprietarul îl construiește pe un calculator, necesar pentru reclame și achiziții în aplicație. Orice altceva răspunde cu 400.

Aplicația trebuie să aibă cod. Dacă este publicată, apelul cere aplicației live și pictograma ei pentru magazine (/icon-512.png), așteptând cel mult 5 secunde.

Răspunsul fără 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."
}
CâmpTipCe înseamnă
appobiectname aplicației și url ei, sau null când nu este publicată.
readylistăCe este pregătit și ce lipsește. Vezi mai jos.
waysobiectO propoziție pentru fiecare cale, easy și native.
onlyInSetherionșirCe poate face doar fereastra Setherion, ca un program să știe unde se termină puterea lui.

Lista ready

Fiecare intrare are item, state și note, iar uneori fix.

CâmpCe înseamnă
itemCe se verifică.
stateok, missing sau unknown când nu a putut fi verificat chiar acum.
noteO propoziție care spune de ce.
fixDoar pe un element missing pe care editorul îl poate adăuga. Textul de trimis la Modifică o aplicație ca prompt, după ce proprietarul este de acord, pentru că o modificare cheltuiește credite.
Elementele care pot apărea
  • Published on the web. ok când aplicația are o adresă. missing când nu are: calea Easy împachetează adresa publicată, așa că publică mai întâi. Calea Native merge și fără ea.
  • Store icon. Apare în listă doar după ce aplicația este publicată. ok când aplicația live oferă pictograma PNG, missing când nu o oferă (publică din nou; o aplicație pe domeniul ei propriu are deocamdată doar pictograma SVG), unknown când aplicația live nu a putut fi verificată.
  • Delete account button. Apare în listă doar când oamenii își pot face cont în aplicație. Apple refuză o astfel de aplicație fără el. missing are un fix.
  • Privacy policy page. Ambele magazine cer un link către una. missing are un fix.

Răspunsul cu way

Aceleași câmpuri și pașii pentru calea pe care ai cerut-o:

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": "..."
}

(Prescurtat aici: răspunsul real are fiecare pas în întregime.)

CâmpTipCe înseamnă
wayșirCalea cerută, easy sau native.
androidlistăPașii pentru Android, în ordine.
iphonelistăPașii pentru iPhone, în ordine.
iphoneNoteslistă de șiruriPentru ce poate Apple să refuze aplicația, fiecare o propoziție, cu titlul pe care îl are în fereastră.

Fiecare pas are:

CâmpTipCe înseamnă
stepnumărLocul lui în listă, de la 1.
titleșirNumele pasului, cel pe care îl arată fereastra.
metașirO linie scurtă: cât durează, de ce are nevoie sau cât costă.
detailșirCe trebuie făcut. Poate avea mai multe linii, cum sunt comenzile de rulat.
linkșirUnde se face, când există un loc. Lipsește altfel.
donebooleanDoar pe pașii pe care Setherion îi poate vedea singur pe calea Easy pentru Android: linkul către site-ul tău și cheia Google Play. Lipsește când nu poate spune.
Pașii fiecărei liste

Easy, Android: fă pachetul Android, leagă aplicația de site-ul tău, deschide un cont de dezvoltator Google Play, încarcă-o și testează-o, adaugă cheia Google Play, completează pagina din magazin și lansează.

Easy, iPhone: deschide un cont de dezvoltator Apple, fă pachetul iPhone, construiește-l și încarcă-l, încearcă-l pe iPhone-ul tău, completează pagina din magazin și trimite-o la verificare.

Native, Android: descarcă proiectul, construiește-l, semnează-l, încarcă-l și testează-l, lansează.

Native, iPhone: descarcă proiectul, construiește-l, semnează-l și încarcă-l, încearcă-l pe iPhone-ul tău, completează pagina din magazin și trimite-o la verificare.

Pe calea Native, comenzile din detail includ pasul de configurare în plus când aplicația arată reclame sau vinde lucruri, plus notele despre reclame și achiziții în aplicație pentru formularele magazinelor.

Erori

StareCând
400way este altceva decât easy sau native.
401Cheia lipsește, este greșită sau a fost revocată.
404Nu există o astfel de aplicație sau cheia ta nu o poate deschide.
409Aplicația nu are încă niciun cod. Construiește-o mai întâi în Setherion.
Propozițiile exacte
Stareerror
400way is "easy" or "native".
404No such app on this account.
409This app has no code yet. Build it in Setherion first.

Ți-a fost de folos această pagină?

Alătură-te comunității

Întrebări, idei și ce construiesc alții.