Мобилни приложения (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
- Създайте акаунт на разработчик на play.google.com/console. Има еднократна регистрационна такса. Регистрирайте се като организация, за което е нужен D-U-N-S номер. Новите лични акаунти първо трябва да проведат затворен тест с група тестери в продължение на две седмици; проверете актуалните правила на Google при регистрацията.
- Създайте ключ за подписване и го пазете извън хранилището:
keytool -genkeypair -v -keystore release.keystore -alias artavolo -keyalg RSA -keysize 2048 -validity 10000. Включете приложението в Play App Signing. - Изградете App Bundle. Можете да го направите локално, с
./gradlew bundleReleaseи свойствата за подписване. Или оставете работния процес да го направи: задайте тези тайни на хранилището и работният процес изгражда и пакета.ANDROID_KEYSTORE_BASE64(файлът с ключовете, кодиран в base64)ANDROID_KEYSTORE_PASSWORDANDROID_KEY_ALIASANDROID_KEY_PASSWORD
- Накарайте връзките да се отварят в приложението. В 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
- Присъединете се към Apple Developer Program като организация (годишна такса и D-U-N-S номер).
- Настройте приложението в Xcode. На Mac изпълнете
npx cap open ios. Под Signing & Capabilities изберете екипа, задайте идентификатора на пакета (com.artavolo.app) и добавете възможността Associated Domains сapplinks:artavolo.com. - Накарайте връзките да се отварят в приложението. Задайте
APP_IOS_IDна<Team ID>.com.artavolo.appвincludes/config.php. Тогава сайтът сервира/.well-known/apple-app-site-association. - Изпратете. В 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.