Puntos de acceso
Preparación para las tiendas
Lo que a una aplicación aún le falta para Google Play y la App Store, y los pasos en orden.
https://www.setherion.com/api/v1/projects/{id}/storePlan: Cualquier plan
La ventana «Publish to app stores» del editor, dicha en datos: qué está listo para las tiendas y, con way, los pasos para Android y iPhone en orden. Lee el código guardado de la aplicación con los mismos ayudantes que la ventana, así que nunca la contradice.
Es gratis y no usa créditos. Basta con acceso de lector. Para las ventanas y el recorrido completo, consulta Publica en las tiendas de aplicaciones.
Petición
Sin way, para comparar primero los dos caminos:
curl https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/store \
-H "Authorization: Bearer $SETHERION_API_KEY"Con way, para los pasos:
curl "https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/store?way=easy" \
-H "Authorization: Bearer $SETHERION_API_KEY"| Parámetro | Significado |
|---|---|
way | Opcional. easy o native. easy envuelve el sitio web publicado en paquetes para las tiendas con PWA Builder, sin código. native es la aplicación entera como proyecto de teléfono que el propietario construye en un ordenador, necesario para anuncios y compras dentro de la aplicación. Cualquier otro valor responde 400. |
La aplicación debe tener código. Si está publicada, la llamada también pide a la aplicación en vivo su icono de tienda (/icon-512.png), esperando como máximo 5 segundos.
Respuesta sin 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."
}| Campo | Tipo | Significado |
|---|---|---|
app | object | El name de la aplicación, y su url o null cuando no está publicada. |
ready | list | Lo que está listo y lo que falta. Mira más abajo. |
ways | object | Una frase para cada camino, easy y native. |
onlyInSetherion | string | Lo que solo puede hacer la ventana de Setherion, para que un programa sepa dónde acaba su alcance. |
La lista ready
Cada entrada tiene item, state y note, y a veces fix.
| Campo | Significado |
|---|---|
item | Lo que se comprueba. |
state | ok, missing, o unknown cuando no se pudo comprobar en ese momento. |
note | Una frase que dice por qué. |
fix | Solo en un elemento missing que el editor puede añadir. El texto que hay que enviar a Edita una aplicación como prompt, una vez que el propietario esté de acuerdo, porque una edición gasta créditos. |
Los elementos que pueden aparecer
- Published on the web.
okcuando la aplicación tiene una dirección.missingcuando no la tiene: el camino Easy empaqueta la dirección publicada, así que publica primero. El camino Native funciona sin ella. - Store icon. Solo aparece una vez publicada la aplicación.
okcuando la aplicación en vivo sirve el icono PNG,missingcuando no lo hace (publica de nuevo; una aplicación en su propio dominio solo tiene el icono SVG por ahora),unknowncuando no se pudo comprobar la aplicación en vivo. - Delete account button. Solo aparece cuando la gente puede crear una cuenta en la aplicación. Apple rechaza una aplicación así si no lo tiene.
missingtrae unfix. - Privacy policy page. Las dos tiendas piden un enlace a una.
missingtrae unfix.
Respuesta con way
Los mismos campos, y los pasos del camino que pediste:
{
"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": "..."
}(Abreviado aquí: la respuesta real trae cada paso completo.)
| Campo | Tipo | Significado |
|---|---|---|
way | string | El camino pedido, easy o native. |
android | list | Los pasos de Android, en orden. |
iphone | list | Los pasos de iPhone, en orden. |
iphoneNotes | list of strings | Por qué puede Apple rechazar la aplicación, cada uno una frase, con título donde la ventana lo titula. |
Cada paso tiene:
| Campo | Tipo | Significado |
|---|---|---|
step | number | Su lugar en la lista, desde 1. |
title | string | El nombre del paso, el que muestra la ventana. |
meta | string | Una línea breve: cuánto tarda, qué necesita o cuánto cuesta. |
detail | string | Qué hacer. Puede tener varias líneas, como los comandos que hay que ejecutar. |
link | string | Dónde hacerlo, cuando hay un lugar. Se omite en otro caso. |
done | boolean | Solo en los pasos que Setherion puede ver por sí mismo en el camino Easy para Android: el enlace con tu sitio y la clave de Google Play. Se omite cuando no puede saberlo. |
Los pasos de cada lista
Easy, Android: hacer el paquete de Android, enlazar la aplicación con tu sitio, abrir una cuenta de desarrollador de Google Play, subirlo y probarlo, añadir la clave de Google Play, rellenar la página de la tienda y publicar la versión.
Easy, iPhone: abrir una cuenta de desarrollador de Apple, hacer el paquete de iPhone, construirlo y subirlo, probarlo en tu iPhone, rellenar la página de la tienda y enviarlo a revisión.
Native, Android: descargar el proyecto, construirlo, firmarlo, subirlo y probarlo, publicar la versión.
Native, iPhone: descargar el proyecto, construirlo, firmarlo y subirlo, probarlo en tu iPhone, rellenar la página de la tienda y enviarlo a revisión.
En el camino Native los comandos de detail incluyen el paso de preparación adicional cuando la aplicación muestra anuncios o vende cosas, y las notas de publicidad y compras dentro de la aplicación para los formularios de las tiendas.
Errores
| Estado | Cuándo |
|---|---|
400 | way es algo distinto de easy o native. |
401 | Falta la clave, es incorrecta o está revocada. |
404 | No existe esa aplicación, o tu clave no puede abrirla. |
409 | La aplicación aún no tiene código. Constrúyela primero en Setherion. |
Las frases exactas
| Estado | 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. |
¿Te ha sido útil esta página?
