Kristofer-Beers/DEMO.md

Spring Boot, Ionic, and Stormpath

This demo script shows pre-recorded IntelliJ Live Template shortcuts to build an Ionic and Spring Boot app. Prerequisites: Java 8, Node.js, Maven, a Stormpath Account, and an apiKey.properties file in ~/stormpath/.

Spring Boot API

Create your Spring Boot API project using start.spring.io.

http https://start.spring.io/starter.zip \/
dependencies==data-jpa,data-rest,h2,web,devtools,security,stormpath -d

1. Run the application with ./mvnw spring-boot:run. Create a Beer entity class in src/main/java/com/example/beer. → boot-entity
2. Create a JPA Repository to manage the Beer entity (tip: @RepositoryRestResource). → boot-repository
3. Create a CommandLineRunner to populate the database. → boot-command
4. Add default data in the run() method. → boot-add
5. Create a BeerController for your REST API. Add some business logic that results in a /good-beers endpoint. → boot-controller
6. Add a /get-beers mapping that filters out beers that aren't great. → boot-good

Access the API using http localhost:8080/good-beers --auth <user>:<password>.

Create Ionic App

Install Ionic and Cordova:

yarn global add cordova ionic

From a terminal window, create a new application using the following command:

ionic start ionic-beer --v2
cd ionic-beer
ionic serve

Upgrade to Angular 2.3

"dependencies": {
  "@angular/common": "2.3.1"

Run yarn to update to these versions.

Install Ionic Pages for Stormpath

Install Ionic pages for Stormpath:

yarn add angular-stormpath-ionic

Modify src/app/app.module.ts to define a stormpathConfig function that configures the endpointPrefix to point to http://localhost:8080. Import StormpathModule, StormpathIonicModule, and override the provider of StormpathConfiguration. You’ll also need to append Stormpath's pre-built Ionic pages to entryComponents. → stormpath-config

To render a login page before users can view the application, modify src/app/app.component.ts to use the Stormpath service and navigate to Stormpath's LoginPage if the user is not authenticated. → io-app

stormpath.user$.subscribe(user => {
  if (!user) {
    this.rootPage = LoginPage;
  } else {
    this.rootPage = TabsPage;
  }
});

If you run ionic serve, you’ll likely see a CORS error in your browser’s console. To fix this, open your Spring Boot application's src/main/resources/application.properties and add the following line.

stormpath.web.cors.allowed.originUris = http://localhost:8100,file://

Restart Spring Boot and your Ionic app.

In src/pages/home.html, add a logout link to the header and a paragraph in the content section that shows the currently logged in user. → io-logout and io-username

Change the body of home.ts to retrieve user$ from the Stormpath service and define the logout() method. → io-home

If you’re logged in, you should see a screen with a logout button and the name of the currently logged in user.

The LoginPage tries to auto-focus onto the email field when it loads. Tell Cordova it’s OK to display the keyboard without user interaction by adding the following to config.xml in the root directory. → io-keyboard

<preference name="KeyboardDisplayRequiresUserAction" value="false"/>

Check your changes into Git.

git add .
git commit -m "Add Stormpath"

Build a Good Beers UI

1. Run ionic generate page beer to create a component and a template to display the list of good beers.
2. Add BeerPage to the declarations and entryComponent lists in app.module.ts.
3. Run ionic generate provider beer-service to create a service to fetch the beer list from the Spring Boot API.
4. Change src/providers/beer-service.ts to use have a getGoodBeers() method. → io-beer-service
5. Modify beer.html to show the list of beers. → io-beer-list
6. Update beer.ts to import BeerService and add as a provider. Call the getGoodBeers() method in the ionViewDidLoad() lifecycle method. → io-get-good-beers
7. To expose this page on the tab bar, add it to tabs.ts. Update tabs.html too!

Add some fun with Giphy! Run ionic generate provider giphy-service. → ng-giphy-service

Update beer.ts to take advantage of GiphyService. → ng-giphy-foreach

Update beer.html to display the image retrieved. → io-avatar

If everything works as expected, you should see a page with a list of beers and images.

Add a Modal for Editing

Change the header in beer.html to have a button that opens a modal to add a new beer. → io-open-modal

In this same file, change <ion-item> to have a click handler for opening the modal for the current item.

<ion-item (click)="openModal({id: beer.id})">

Add ModalController as a dependency in BeerPage and add an openModal() method. → io-open-modal-ts

This won't compile because BeerModalPage doesn't exist. Create beer-modal.ts in the same directory. → io-beer-modal

Create beer-modal.html as a template for this page. → io-beer-modal-html

Add BeerModalPage to the declarations and entryComponent lists in app.module.ts.

You'll also need to modify beer-service.ts to have get() and save() methods. → io-get-save

Add Swipe to Delete

To add swipe-to-delete functionality on the list of beers, open beer.html and make it so <ion-item-sliding> wraps <ion-item> and contains the *ngFor. → io-swipe

Add a remove() method to beer.ts. → io-remove

Add toastCtrl: ToastController as a dependency in the constructor so everything compiles.

After making these additions, you should be able to add, edit and delete beers.

PWAs with Ionic

Run the Lighthouse Chrome extension on this application. To register a service worker, and improve the app’s score, uncomment the serviceWorker block in index.html.

After making this change, the score should improve. In my tests, it increased to 69/100.

If you refresh the app and Chrome doesn’t prompt you to install the app (a PWA feature), you probably need to turn on a couple of features.

chrome://flags/#bypass-app-banner-engagement-checks
chrome://flags/#enable-add-to-shelf

After enabling these flags, you’ll see an error in your browser’s console about assets/imgs/logo.png not being found. This files is referenced in src/manifest.json. You can fix this by copying a 512x512 PNG into this location or by modifying manifest.json accordingly.

Deploy to a Mobile Device

To see how your application will look on different devices you can run ionic serve --lab. The --lab flag opens opens a page in your browser that lets you see how your app looks on different devices.

iOS

To emulate or deploy to an iOS device, you’ll need a Mac and a fresh installation of Xcode. If you’d like to build iOS apps on Windows, Ionic offers an Ionic Package service.

ionic platform add ios

You’ll need to run ionic emulate ios to open your app in Simulator.

The biggest problem I found when running the app in Simulator was that it was difficult to get the keyboard to popup. To workaround this, I used Edit > Hardware > Keyboard > Toggle Software Keyboard when I needed to type text in a field.

To deploy the app to an iPhone, start by plugging your iOS device into your computer. Then run the following commands to install ios-deploy/ios-sim, build the app, and run it on your device.

npm install -g ios-deploy ios-sim
ionic build ios --prod
cd platforms/ios/
open ionic-auth.xcodeproj

Select your phone as the target in Xcode and click the play button to run your app. The first time you do this, Xcode may spin for a while with a “Processing symbol files” message at the top.

Once you’re configured your phone, computer, and Apple ID to work, you should be able to open the app and see login, register, and forgot password screens.

Android

To emulate or deploy to an Android device, you’ll first need to install Android Studio. As part of the install, it will show you where it installed the Android SDK. Set this path as an ANDROID_HOME environment variable. On a Mac, it should be ~/Library/Android/sdk/.

To deploy to the Android emulator, add support for it to the ionic-auth project using the ionic command.

ionic platform add android

If you run ionic emulate android you’ll get instructions from about how to create an emulator image.

Error: No emulator images (avds) found.
1. Download desired System Image by running: /Users/mraible/Library/Android/sdk/tools/android sdk
2. Create an AVD by running: /Users/mraible/Library/Android/sdk/tools/android avd
HINT: For a faster emulator, use an Intel System Image and install the HAXM device driver

I ran the first suggestion and downloaded my desired system image. Then I ran the second command and created an AVD with the following settings:

AVD Name: TestPhone
Device: Nexus 5
Target: Android 7.1.1
CPU/ABI: Google APIs Intel Axom (x86_64)
Skin: Skin with dynamic hardware controls

After performing these steps, I was able to run ionic emulate android and see my app running in the AVD.