Spuštění aplikace
Aplikaci je třeba připravit a zbuildovat. K tomu spusťte následující příkazy.
Příkazy se spouští v příkazové řádce v linuxu nebo osx. Pro windows používáme git-bash.
Tady je návod na instalaci prostředí pro windows, iOS
Pro Android:
./aprepare.sh
./abuild.sh
Pro iOS:
./iprepare.sh
./ibuild.sh
Pro Windows Phone:
./wprepare.sh
./wbuild.sh
Skripty vytvoří verzi aplikace pro vývoj / interní testování. Pro tvorbu verze k distribuci slouží skripty: adist.sh, idist.sh, wdist.sh.
Výsledkem skriptu je .apk nebo .ipa soubor v kořenu projektu.
Buildovací skripty
Takto se buildují všechny naše aplikace. Skripty jsou udělané tak, aby je mohl spouštět integrační server Jenkins.
- Prepare
- Vytvoří strukturu pro platformu cordova: přidá platformy a pluginy. Může dělat změny Info.plist a android.xml.
- Build
- Zkompiluje aplikaci pro vývoj / test. Vytvoří v adresáři soubor s názvem PROJEKT-VERZE-BUILD.apk/ipa
- Publikace
- Vypublikuje verzi pro interní testování
- Release
- Vypublikuje verzi pro testování pro klienta
- Distribuce
- Kompiluje aplikaci, vytvoří balíček k distribuci na portály
Přehled build skriptů:
Android | iOS | Windows Phone | |
---|---|---|---|
Prepare | ./aprepare.sh | ./iprepare.sh | ./wprepare.sh |
Build | ./abuild.sh | ./ibuild.sh | ./wbuild.sh |
Publikace | ./apub.sh | ./ipub.sh | N/A |
Release | ./arelease.sh | ./irelease.sh | N/A |
Distribuce | ./adist.sh | ./idist.sh | ./wdist.sh |
Struktura projektu - Cordova
- config.xml
- definice projektu
- build.json
- informace o buildování na iOS
- .gitignore
- definice toho, co se nemá ukládat do gitu
- cert
- certifikáty, provisioning profily
- libs
- pluginy, které se nestahují z webu
- res/icon
- ikony
- res/splash
- splashe
- www
- zdrojáky
Struktura projektu - Ionic 2
- config.xml
- definice projektu
- build.json
- informace o buildování na iOS
- .gitignore
- definice toho, co se nemá ukládat do gitu
- cert
- certifikáty, provisioning profily
- libs
- pluginy, které se nestahují z webu
- resources/icon
- ikony
- resources/splash
- splashe
- src
- zdrojáky
Bacha, zdrojáky jsou ve složce /src, odkud probíhá kompilace do /www. Adresář /www se do gitu neukládá, vytváří ho prepare skript.
Struktura minimálního projektu
Když je potřeba něco vyzkoušet
- config.xml
- definice projektu
- www/index.html
- HTML soubor s aplikací
Soubory
Soubor .gitignore definuje, co se do gitu neukládá.
Do GITu nepatří: platforms, plugins, *.apk, *.ipa
config.xml
Definuje název, verzi a parametry aplikace. Dále ikony a splash screeny. Zde se nepřidávají žádné pluginy (na rozdíl od phonegapu), pouze parametry!
Tag widget musí být v jednom řádku takto, protože ho očekávání build skripty:
<widget id="cz.inited.aplikace" version="1.0.9" xmlns="http://www.w3.org/ns/widgets" xmlns:cdv="http://cordova.apache.org/ns/1.0">
Ikony a splashe
Aktuálně používáme pouze obrázky ve formátu PNG. Pojmenovávají se takto: icon512x512.png, splash1536x2048.png.
Certifikáty a provisioning profily
Pro většinu projektů (které nepoužívají Apple Push Notifications) vystačíme s tímto:
- pro vývoj a testování, předávání zákazníkům
- Android: debug.keystore
- iOS: development certifikát Jaroslav Pavlíček, provisioning profile VsichniVsechno. Certifikát generuje Jarda jednou za rok. Provisioning po každém přidaném zařízení.
- pro distribuci, v adresáři cert:
- proj-dist.keystore - keystore s certifikátem pro distribuci Androidu (http://developer.android.com/tools/publishing/app-signing.html)
- proj-dist.p12 - distribuční certifikát od Apple dev portálu
- proj-dist.mobileprovision - distribuční profil z Apple dev portálu
Generování certifikátu pro Android:
$ keytool -genkey -v -keystore my-release-key.keystore
-alias alias_name -keyalg RSA -keysize 2048 -validity 10000