Напускате Airtable? Пренесете базите си в Artavolo, проверени запис по запис. Вижте как

Мобилни приложения (Android и iOS)

Artavolo работи на телефони по три начина:

  • Браузърът. Екранът на таблицата, интерфейсите и формулярите са оформени за телефони: изглед „Таблица“ си остава таблица с тясна колона, чийто номер отваря записа, менютата се отварят като панели отдолу, а записите се отварят на цял екран с плъзгане към следващия.
  • Инсталирано от браузъра. Chrome, Edge и Safari предлагат да инсталират сайта като приложение. То има собствена икона и прозорец и показва страница „Няма връзка“, когато няма мрежа.
  • От Google Play и App Store. Приложенията в mobile/ поставят същите екрани в нативна обвивка. Те добавят икона на началния екран, начален екран при стартиране и връзки, които се отварят в приложението.

Приложенията отварят самия сайт, така че винаги са актуални. Промяна в Artavolo стига до приложенията без нова версия.

Какво има в mobile/

ПътКакво представлява
capacitor.config.jsonАдресът, който приложението отваря, името му и идентификаторът му. Записва се от scripts/configure.mjs.
android/, ios/Нативните проекти (Capacitor 8).
www/Собствените страници на приложението: неговата рамка и офлайн страницата, която се показва, когато сайтът не може да бъде достигнат.
scripts/icons.mjsРисува всяка икона и начално изображение от знака, във всеки размер, който всяка платформа изисква.
.github/workflows/mobile.ymlИзгражда и двете приложения в GitHub: инсталируема тестова версия за Android и версия за симулатор на iOS.

Изграждане

Нужен ви е Node 22. За Android ви трябват още JDK 21 и Android SDK (платформа 35). За iOS ви трябва Mac с Xcode.

cd mobile
npm ci
node scripts/configure.mjs                  # artavolo.com, "Artavolo", com.artavolo.app
npx cap sync
cd android && ./gradlew assembleDebug       # app/build/outputs/apk/debug/app-debug.apk
npx cap open ios                            # then build and run in Xcode

Вашата собствена инсталация или под ваше име

Инсталация на собствен сървър или с бяла марка получава собствено приложение. Дайте му собствен адрес, име и идентификатор и прерисувайте иконите от неговия знак:

node scripts/configure.mjs --url https://tables.acme.eu --name "Acme Tables" --id eu.acme.tables
node scripts/icons.mjs path/to/acme-mark.svg "#ffffff"
npx cap sync

В GitHub пуснете ръчно работния процес „Mobile apps“ със същите три стойности.

Публикуване

Google Play

  1. Създайте акаунт на разработчик на play.google.com/console. Има еднократна регистрационна такса. Регистрирайте се като организация, за което е нужен D-U-N-S номер. Новите лични акаунти първо трябва да проведат затворен тест с група тестери в продължение на две седмици; проверете актуалните правила на Google при регистрацията.
  2. Създайте ключ за подписване и го пазете извън хранилището: keytool -genkeypair -v -keystore release.keystore -alias artavolo -keyalg RSA -keysize 2048 -validity 10000. Включете приложението в Play App Signing.
  3. Изградете App Bundle. Можете да го направите локално, с ./gradlew bundleRelease и свойствата за подписване. Или оставете работния процес да го направи: задайте тези тайни на хранилището и работният процес изгражда и пакета.
    • ANDROID_KEYSTORE_BASE64 (файлът с ключовете, кодиран в base64)
    • ANDROID_KEYSTORE_PASSWORD
    • ANDROID_KEY_ALIAS
    • ANDROID_KEY_PASSWORD
  4. Накарайте връзките да се отварят в приложението. В Play Console отворете App integrity и копирайте SHA-256 отпечатъка на сертификата за подписване на приложението. Задайте APP_ANDROID_ID и APP_ANDROID_SHA256 в includes/config.php. Тогава сайтът сервира /.well-known/assetlinks.json, а Android отваря в приложението връзките към /base/…, /interface/… и /form/….

App Store

  1. Присъединете се към Apple Developer Program като организация (годишна такса и D-U-N-S номер).
  2. Настройте приложението в Xcode. На Mac изпълнете npx cap open ios. Под Signing & Capabilities изберете екипа, задайте идентификатора на пакета (com.artavolo.app) и добавете възможността Associated Domains с applinks:artavolo.com.
  3. Накарайте връзките да се отварят в приложението. Задайте APP_IOS_ID на <Team ID>.com.artavolo.app в includes/config.php. Тогава сайтът сервира /.well-known/apple-app-site-association.
  4. Изпратете. В Xcode изберете Product, после Archive, после Distribute App, после App Store Connect. След това попълнете описанието в App Store Connect.

За прегледа на Apple. Apple отхвърля приложения, които са само уебсайт в рамка (насока 4.2). Какво добавя това приложение:

  • офлайн страницата;
  • връзки, които се отварят в приложението;
  • началния екран;
  • файлове и снимки направо от камерата, в полета за прикачени файлове.

Дайте на проверяващите демо акаунт с попълнена база. Известията на телефона (Web Push, вижте по-долу) подсилват случая.

Вход в приложението

Хората влизат в приложението по същите начини както в уебсайта и нищо ново не трябва да се помни:

  • Google, Microsoft или Apple. Приложението отваря доставчика в собствения браузър на телефона, където повечето хора вече са влезли в Gmail или в служебния си акаунт. Докосват акаунта си веднъж и са обратно в приложението, влезли. (Google отказва вход във вградения уеб изглед на приложение, затова се отваря браузърът.) Токенът на връщане е безполезен за всяко друго приложение: само приложението, което е започнало входа, държи тайната, която го превръща в сесия.
  • Код по имейл. „Изпратете ми код за вход“ изпраща 6-цифрен код и връзка, валидни 10 минути. Нищо за помнене и работи за всеки акаунт.
  • QR код от уебсайта. В менюто на акаунта на компютъра „Вход на телефона“ показва QR код. Сканирайте го с камерата на телефона: телефонът е влязъл, в приложението, ако е инсталирано. Кодът работи веднъж, за 5 минути.
  • Имейл и парола, както преди, и еднократен вход (SSO), където компанията го има.

Microsoft и Apple се появяват, щом ключовете им бъдат зададени в администрацията, Настройки за удостоверяване. App Store изисква Sign in with Apple до Google (насока 4.8).

Какво прави сайтът за приложенията

  • Разпознаване на приложението. Приложението добавя ArtavoloApp/1.0 към своя user agent и сайтът по него разбира, че е вътре в приложението: бутоните за доставчиците тогава се отварят в браузъра на телефона (вижте по-горе).
  • Назад и връзки. Бутонът „назад“ на Android връща страница назад и затваря приложението на първата страница. Връзка, докосната другаде, отваря страницата в приложението (partials/app-install.phtml).
  • Офлайн. Без мрежа приложението показва собствената си страница „Няма връзка“ и опитва отново, когато телефонът е пак онлайн.

Известия и сканиране

  • Известията на телефона работят чрез Web Push от браузъра или инсталираното приложение и се изпращат от сървъра на чист PHP (не са нужни данни за Firebase или Apple Push). Всеки човек ги включва от камбанката. Нативни push известия в приложенията от Google Play и App Store още не са изградени.
  • Сканирането на баркод и QR код в поле за баркод или за намиране и отваряне на запис ползва собствения четец на баркодове на браузъра, който Chrome на Android има. Safari на iPhone още го няма.
  • Снимането на снимка в поле за прикачен файл работи във всеки браузър на телефон и в приложенията; снимките се изпращат най-много с ширина 2000 px.
Въпрос, на който тези страници не отговарят? Пишете ни и ще ви отговорим по имейл, обикновено в рамките на един работен ден. Свържете се с нас