Skip to content

Based on start-a4; extended with more pages and services.

License

Notifications You must be signed in to change notification settings

hhzl/ionic4-start-a5

Repository files navigation

Screen shots mobile phone app

Home page

Screen shot Home Page

Choose ABC page

Screen shot Choose ABC Page

Picture with labels page

Screen shot Picture with Labels Page

Settings page

Screen shot Settings Page

Language selection page

Screen shot Language Selection Page

INSTALLATION OF TOOLS

Make sure the Node.js and npm are installed. Commands for Linux see https://github.com/nodesource/distributions

Then install ionic and cordova from the command line with:

npm install -g ionic

npm install -g cordova

This repository was developed with the following versions:

ionic info

Ionic:

   Ionic CLI                     : 5.2.0 (/usr/lib/node_modules/ionic)
   Ionic Framework               : @ionic/angular 4.11.5
   @angular-devkit/build-angular : 0.801.3
   @angular-devkit/schematics    : 8.1.3
   @angular/cli                  : 8.1.3
   @ionic/angular-toolkit        : 2.1.1

Utility:

   cordova-res : not installed
   native-run  : 0.2.9 

System:

   NodeJS : v10.17.0 (/usr/bin/node)
   npm    : 6.11.3
   OS     : Linux 4.15

SETUP OF DEVELOPMENT AND TEST ENVIRONMENT FOR THE APPLICATION

Assuming git is installed

git clone https://github.com/hhzl/ionic4-start-a5.git

cd ionic5-start-a5

npm install

npm test

Otherwise download the file https://github.com/hhzl/ionic4-start-a5/archive/master.zip and unzip it. Then

cd ionic5-start-a5

npm install

npm test

This shows the tests.

Screen shot Chrome browser of npm test

See below how to run the app locally in a browser.

RUN THE APP IN THE BROWSER

To run the application in a web browser execute on the command line

ionic serve

Then use the indicated local web address such as http://localhost:8100 .

HOW SCAFFOLDING WAS DONE

The scaffolding of the code in the repository was done with

ionic start ionic4-start-a5 blank --type=angular
cd ionic4-start-a5


ionic generate service services/BoxOfQuestions
ionic generate service services/LWdb
ionic generate service services/Data
ionic generate service services/Settings


ionic generate page pages/choose-mode
ionic generate page pages/choose-mode-m
ionic generate page pages/choose-abc
ionic generate page pages/learn-mode
ionic generate page pages/learn-mode-m
ionic generate page pages/picture-with-labels
ionic generate page pages/practice-mode
ionic generate page pages/wordlist
ionic generate page pages/about
ionic generate page pages/settings
ionic generate page pages/languageSelection
ionic generate page pages/languageSelection2
ionic generate page pages/summary
 

The generated code is in the src directory and has to be configured. Such as for example changeing the header of the pages files (home page excluded) to

<ion-header>
  <ion-toolbar color="primary">
    <ion-title>...</ion-title>
    <ion-buttons slot="start">
      <ion-back-button></ion-back-button>
    </ion-buttons>
  </ion-toolbar>
</ion-header>

The header of the page home.page.html is

<ion-header>
    <ion-toolbar color="primary">
    <ion-buttons slot="end">
        <ion-button routerLink="/about">
            <ion-icon name="information-circle"></ion-icon>
        </ion-button>
    </ion-buttons>
    <ion-title>Ionic 4 start a5</ion-title>
    </ion-toolbar>
</ion-header>

RUN THE APP ON THE DEVICE

Android

Android environment setup: https://ionicframework.com/docs/installation/android, available for Windows, macOS and Linux.

Build apk file with

ionic cordova run android

Note about testing

To make 'should create' tests work for pages

import { RouterTestingModule } from '@angular/router/testing';

has to be imported and then used in

imports: [IonicModule.forRoot(),RouterTestingModule]