Slanje e-maila iz Ionic mobilne aplikacije pomoću Mailgun APIja

Kada korisnicima vaše Ionic mobilne aplikacije želite omogućiti da vam direktno iz nje pošalju e-mail bez potrebe za pokretanjem njihovog zadanog e-mail klijenta imate dvije mogućnosti. Složiti svoj API ili koristiti API koji vam nudi Mailgun. Mailgun omogućava slanje 10 000 e-mailova mjesečno potpuno besplatno, a detalje o implementaciji možete vidjeti u nastavku blog posta i u njihovoj dokumentaciji.

Podrazumijeva se da ste prije toga postavili razvojnu okolinu, pokrenuli novi Ionic projekt i dodali podršku za Android platformu.

Postavljanje kontrolera

Kontroler koji ćemo u ovom primjeru staviti u www/js/app.js

U kontroleru možete odmah definirati primatelja $scope.recipient = "tomislavstankovic@example.com"; kako ga korisnici aplikacije ne bi morali svaki put unositi. Zapravo primatelj u ovom slučaju uopće ne mora biti vidljiv jer ionako je uvijek isti, ali za potrebe ovog blog posta ću ga ostaviti vidljivog u formi.

Kako bi kontroler uopće radio ono za što je namijenjen morate postaviti varijable mailgunUrl (za potrebe testiranja možete koristiti njihovu besplatnu sandbox domenu) i mailgunApiKey. Sve to dobijete odmah nakon registracije.

Forma za slanje e-maila

Sada možete napraviti i formu za slanje.

Forma sada izgleda ovako. Ovisno o potrebama možete određena polja prikazati ili ukloniti.

Ionic & Mailgun forma za slanje e-maila

Ako sada pokrenete aplikaciju u web pregledniku $ ionic serve ili na mobilnom uređaju $ ionic run android dobit ćete poruku o grešci.

Kako bi to zaobišli u index.html dodajte sljedeće, a možete dodati i CORS u Google Chrome.

Sada ste spremni za slanje prvog e-maila.

Ionic Framework & Mailgun API - Uspješno poslan email

I to je to. Provjerite svoj inbox.

Ionic Framework & MailgunAPI uspješno primljen e-mail-1

Zaključak

Ovo je samo jedan od mogućih scenarija za slanje elektroničke pošte unutar Ionic aplikacije. Prednost ovakvog načina slanja elektroničke pošte je ta što korisnici ne moraju napustiti vašu Ionic aplikaciju kako bi vam poslali e-mail.

Ionic aplikacija (ni)je povezana s internetom

Jedna od osnovnih pretpostavki prilikom razvoja mobilne aplikacije je da će ista posebno ovisiti o povezanosti s internetom. Zbog toga je važno znati kako upravljati različitim situacijama u kojima ne postoji mrežna povezanost ili je ista ograničena. Kao developer trebate imati mogućnost dohvaćanja statusa mreže kao bi mogli implementirati opcije A (ima interneta – prikaži podatke), B (nema interneta – prikaži kopiju podataka iz lokalne memorije) ili C (nema interneta – prikaži obavijet i čekaj vezu s internetom kako bi prikazao podatke).

Korisnik aplikacije o tome treba biti obaviješten kako ne bi pomislio da nešto nije u redu s njegovim mobilnim uređajem ili s aplikacijom.

Naravno, prije dodavanja $cordovaNetwork plugina već ste pokrenuli novi Ionic projekt, dodali Android platformu i podršku za ngCordova.

$cordovaNetwork plugin

Dodajte ga u Ionic aplikaciju pokretanjem naredbe

Nakon instalacije u direktoriju plugins primjetit ćete novi direktorij cordova-plugin-network-information

Ionic Cordova Network plugin

U dokumentaciji plugina možete vidjeti koje opcije vam pruža Connection objekt.

Connection Type                          Description
Connection.UNKNOWN              Unknown connection
Connection.ETHERNET               Ethernet connection
Connection.WIFI                          WiFi connection
Connection.CELL_2G                   Cell 2G connection
Connection.CELL_3G                   Cell 3G connection
Connection.CELL_4G                   Cell 4G connection
Connection.CELL                          Cell generic connection
Connection.NONE                         No network connection

Sljedećim primjerom prikazat ćete informaciju o (ne)postojanju internet veze i vrsti veze.

Prikaz statusa internet veze

Na mobilnom uređaju to izgleda ovako

Ionic ngCordova Network Android

Apache Cordova

Sljedećim primjerom pokrivate opciju kada mobilni uređaj nije povezan s internetom (Connection.NONE). U ovom primjeru ne treba vam ngCordova.

Na mobilnom uređaju to izgleda ovako

Ionic Cordova Network Android

Koristiti factory!?

Najbolja opcija je napraviti factory koji onda možete koristiti kroz cijelu Ionic aplikaciju.

Factory možete pozvati u bilo koji kontroler.

Zaključak

Ovo su samo tri mala informativna primjera kako možete koristiti $cordovaNetwork plugin u Ionic aplikaciji.

Ovaj je plugin posebno koristan kada u aplikaciji prikazujete podatke s nekog vanjskog izvora. Znači, ako nestane veze s internetom neće se više prikazati niti podaci koje želite dati korisniku, a korisnik neće znati zašto se to dogodilo. Jednom kada utvrdite da veza s internetom ne postoji trebate odlučiti što i kako dalje. Možete o tome obavijestiti korisnika ili mu u tom slučaju prikazivati podatke iz lokalne memorije sve dok se ponovno ne uspostavi veza s internetom.

Ikona i početni zaslon Ionic aplikacije

Prva stvar koju će korisnici vidjeti kada požele preuzeti vašu aplikaciju je ikona, a prva stvar koju će vidjeti prilikom pokretanja aplikacije je početni zaslon (Splash Screen). Prema tome, ikona i početni zaslon igraju važnu ulogu za prvi dojam.

S obzirom da Ionic aplikacije možete istovremeno raditi za iOS i Android te da su uređaji na kojima se nalaze različitih dijagonala ekrana postavlja se pitanje kako na što jednostavniji način obuhvatiti sve te uređaje a da na kraju ikona i početni zaslon na oba OS-a i na svim dijagonalama ekrana izgledaju dobro. Odgovor na to je Ionic Resources.

Kada pokrenete novi Ionic projekt i dodate Android platformu

dobijete direktorij resources u kojemu se nalaze ikona aplikacije icon.png i slika za početni zaslon splash.png

Ionic aplikacija resursi

te se u config.xml pojavi sljedeće

U config.xml po želji možete dodati i druge parametre.

Uglavnom, sada već imate ikonu aplikacije i početni zaslon u što se možete uvjeriti pokretanjem naredbe

Ikona i pocetni zaslon Ionic aplikacije

Prilagođeni početni zaslon i ikona

Ako želite staviti custom ikonu i početni zaslon kopirajte u resources direktorij dvije slike. Jednu naziva icon.png veličine 1024x1024px i splash.png veličine 2208x2208px i pokrenite naredbu

Ionic aplikacija resursi 2

Ionic CLI će automatski izrezati sve potrebne dimenzije ikone i početnog zaslona.

Ako sada pokrenete $ ionic run android vidjet ćete novu ikonu i novi početni zaslon

Nova ikona i početni zaslon Ionic aplikacije

U slučaju da ne želite istovremeno promijeniti ikonu aplikacije i početni zaslon nego ih postavljate posebno možete koristiti naredbe

Ako vam niti to nije dovoljno nego želite koristiti npr. različite ikone za Android i iOS to možete učiniti na način da kopirate icon.png u resources/android/ za Android odnosno u resources/ios/ za iOS.

Zaključak

Ikona vaše Ionic aplikacije i početni zaslon sigurno će utjecati na prvi dojam koji će korisnici dobiti o aplikaciji. U ovom ste blog postu mogli vidjeti koliko je jednostavno promijeniti ih.

Što je i čemu služi ngCordova unutar Ionic aplikacije?

U pravilu, sve što radi u web pregledniku radit će i u vašoj hibridnoj mobilnoj aplikaciji. Ipak, mobilne aplikacije često zahtijevaju više od mogućnosti samog web preglednika jer ipak mobilni uređaji imaju različite senzore i ostale funkcionalnosti (žiroskop, vibracija i dr.) bez čega vaša hibridna mobilna aplikacija ne bi bila ništa više od neke obične responzivne web stranice. Tu uskaču Apache Cordova tj. ngCordova koji će vam omogućiti korištenje upravo tih nativnih funkcionalnosti mobilnog uređaja.

Prije nego se odlučite za korištenje nekog plugina zapitajte se koliko vam je stvarno potreban i koja ograničenja povlači za sobom.

P.S. Pluginove isprobavajte i testirajte na mobilnom uređaju umjesto u web pregledniku.

Apache Cordova

Cordova se u vašem Ionic projektu nalazi od samog početka ako se sjetite naredbe $ npm install -g cordova ionic, a da je to stvarno tako možete se uvjeriti ako bacite pogled na index.html.

S tako postavljenim Ionic projektom spremni ste za korištenje Cordova pluginova.

Plugin ćete dodati jednostavnom naredbom cordova plugin add. Svaki plugin ima svoju dokumentaciju, ili bi trebao imati, i svakako ju detaljno proučite prije nego se odlučite na korištenje nekog plugina.

ngCordova

Kako je ovdje primarno riječ o razvoju hibridnih mobilni aplikacija pomoću Ionic Frameworka važno je znati da postoji puno elegantnije rješenje kada su u pitanju pluginovi, a to je ngCordova.

ngCordova je set odabranih Apache Cordova pluginova prilagođenih Ionic Frameworku.

Koristeći Ionic CLI dodajte podršku za korištenje ngCordova pluginova unutar Ionic aplikacije.

Primjetit ćete novi direktorij unutar www/lib/

ngCordova Ionic

Sljedeći korak je pozvati ng-cordova.js unutar index.html

I zadnji korak je uključiti taj novi modul u Ionic aplikaciju. Otvorite www/js/app.js i dodajte ‘ngCordova’ unutar uglate zagrade.

Sada ste spremni za dodavanje pluginova.

Nakon što ste dodali plugin ubacite njegov kod, kojega ćete vidjeti u dokumentaciji, u kontroler i obavezno ga pišite unutar $ionicPlatform.ready() jer inače bi mogli vidjeti hrpu undefined errora.

Prikažite rezultat.

Zaključak

Nadam se da ste kroz ovaj blog post uspjeli shvatiti što su Apache Cordova tj. ngCordova i kako na jednostavan način mogu nadopuniti vašu Ionic aplikaciju. U nekom od idućih blog postova planiram prikazati konkretnu implementaciju pojedinih ngCordova pluginova.

Što je Ionic View?

Kada radite Ionic mobilne aplikacije i želite ih podijeliti s drugima tj. dobiti povratne informacije imate nekoliko mogućnosti:

  • Svaki put kada napravite neku promjenu svima slati mail koji sadržava .apk/.ipa
  • Čekati da osobe dođu kod vas kako bi mogli spojiti njihove mobilne uređaje na računalo i ručno instalirati .apk/.ipa
  • Napraviti Google Play Developer i/ili Apple App Developer korisnički račun, platiti članarinu i postaviti aplikaciju u beta test
  • Putem Ionic Viewa omogućiti svima da gotovo trenutno vide svaku promjenu koju ste napravili

Vjerujem da vam se najboljom čini zadnja opcija. Upravo to, pa i više od toga omogućava Ionic View kao što ćete vidjeti u nastavku.

1. Registracija

Ako ste se već registrirali prema uputama iz prethodnog blog posta onda ovaj korak možete preskočiti. U suprotnom unesite potrebne podatke i kliknite na Sign Up.

Ionic View registracija

2. Upload aplikacije

U direktoriju aplikacije pokrenite naredbu te unesite svoje korisničko ime i lozinku.

U slučaju da se prvi put prijavljujete, vidjet ćete sljedeće. Posebno obratite pažnju na liniju broj 11 u kojoj se nalazi ID aplikacije. Upravo ćete putem tog ID-a omogućiti određenim osobama da pregledavaju vašu aplikaciju.

3. Preuzimanje Ionic View aplikacije

Preuzmite Ionic View mobilnu aplikaciju. Aplikaciju možete pronaći na Apple App Store i Google Play Store.

Nakon instalacije aplikacije potrebno je samo prijaviti se sa svojim korisničkim podacima. Odaberite aplikaciju, kliknite na Download files i konačno View app.

Ionic View mobilna aplikacija

4. Dijeljenje aplikacije

4.1. Aplikaciju možete početi dijeliti pomoću naredbe

Nakon čega pozvanoj osobi stiže email

Ionic View email

Aplikaciju također možete vidjeti i na https://apps.ionic.io/apps

Ionic View popis aplikacija

U web sučelju možete vidjeti kome ste sve poslali pozivnice za pristup vašoj aplikaciji, vidjeti koje su osobe pozivnicu prihvatile i poslati nove pozivnice.

Ionic View detalji aplikacije

4.2. Aplikaciju možete podijeliti i pomoću ID-a na način da unesete ID aplikacije i učitate aplikaciju u sučelje Ionic Viewa.

Ionic View ID aplikacije

Zaključak

Ionic View je odličan i jednostavan način da podijelite svoju aplikaciju, posebno tijekom razvoja. Osim toga Ionic.io nudi još i Ionic Push, Ionic Analytics, Ionic Deploy i Ionic User. O tim funkcionalnostima se ima što za pisati tako da ih neću detaljnije obrađivati u ovom blog postu, ali planiram u nekom od sljedećih.