Ionic2環境搭建及文件目錄介紹


[注]轉載自:http://blog.csdn.net/jasonzds/article/details/53821184

1環境搭建

一年前研究混合框架,初步確定了四種方案給公司選擇,ionic,hbuilder,wex5,react-native這四個框架各有優缺點,ionic和react-native是國外框架,相對好一點,文檔更新很快,就不一一說了,大概的思路都是一樣的,js邏輯實現,同時調用原生功能,h5,css3 UI實現,其實他們都有自己的ui框架,當時選擇了國內的hbuiler,開發了三款應用,iOSAndroid都有,今天同樣公司發展的改變,整體框架都變了,ionic2框架重新提上了方案,決定用ionic2開發hybird應用(具體原因你猜),后續會有系列的博客分享。

 

安裝ionic最新版本

ionic官網地址:http://ionicframework.com

1.准備工作

下載 Node.js(下載包),WebStorm(IDE,編寫代碼,瀏覽器調試),JDK(webstorm 運行環境),Android SDK(Android編譯)

Ionic 2 程序主要通過Ionic命令行工具 CLI 來創建和開發,並使用 Cordova 來構建和部署為原生應用程序。也就是說我們需要先安裝一些工具來實現程序開發

要創建 Ionic 2 項目,你需要安裝最新版本的 CLI 和 Cordova 。在此之前你需要安裝最新版本的 Node.js 。點這里 下載安裝 Node.js ,然后繼續安裝 Ionic CLI 和 Cordova 來進行應用程序開發:

命令前面可能需要添加 sudo 提權來進行全局安裝。

安裝 Ionic

npm install -g ionic

 

安裝 Cordova

npm install -g cordova

 

查看ionic版本

ionic –v

 

查看cordova版本

cordova –v

 

更新ionic和cordova包

npm update -g cordova ionic

 

更新已建ionic項目中的js類庫,命令行中先進入項目所在目錄

ionic lib update

 

展現ionic項目結果(顯示在iOSAndroid上的樣式)

ionic serve –lab

 

創建項目

ionic start myApp blank(空項目) 

ionic start myApp tabs(帶導航條) 

ionic start myApp sidemenu(帶側滑菜單)

 

添加android/ios平台

ionic platform add android/ios(添加android平台/ios) 

ionic platform remove android/ios(移除android平台/ios) 

ionic build android/ios(編譯項目apk,ipa)

ionic emulate android/ios(運行項目apk 手機連接在手機運行 模擬器連接在模擬器運行) 

 

生成android/ipa安裝包(生成后apk/ipa的存放路徑在終端種可以看到)

ionic build android/ios

 

ionicrun android/ios (相當於build + emulate) 

ionicserve (開啟服務調試) 

 

指明一個外部的ip地址,可以讓外部用戶查看。

ionic serv --address 68.52.96.10

 

使用設備運行應用,如果無設備可用將自動使用模擬器

ionic run ios [options]

//options的選項包括:

-l livereload, 實時刷新變化。

-c 打印app里的console

-s 打印設備的console

-p 指定設備的端口

-i 指定livereload的重刷端口

--debug|--release

//當處於livereload模式時,使用r重啟客戶端,使用 g your_url 跳轉到指定url, 使用c啟動或關閉console,使用s啟動或關閉設備的console, 使用q退出。

 

//查看系統情況

ionic info

 

安卓自帶瀏覽器性能不好,可以強行安裝一個殼,這將安裝一個Chromium內核。

ionic browser add crosswalk

 

查看可用的browser

ionic browser list

 

刪除安裝的browser

ionic browser revert android

2 項目目錄分析

安裝完成后來創建你的第一個 Ionic 應用:

ionic start MenuDemo sidemenu --v2

MenuDemo可以替換成你的應用程序名稱。 --v2 表示當前生成的是 Ionic 2 版本的應用,不添加則生成 Ionic 1 應用。

創建完成后 cd 到你的程序目錄中,執行 ionic serve 來啟動你的Ionic應用,並確保測試在瀏覽器中能夠正常顯示:

cd MenuDemo

ionic serve

瀏覽器運行起來是這樣的

 

 

 

 

 

 

 

 

 

 

 

 

 

 

項目結構

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

讓我們來剖析一下Ionic 2應用,在我們創建的文件夾中,我們可以看到一個典型的Cordova項目結構。我們可以在其中安裝原生插件,並創建平台特定的項目文件。

src/index.html

是 Ionic 2 應用的主入口文件,其目的是設置腳本和CSS引導,然后開始運行我們的應用程序。 我們不會在這個文件中花費大量的時間。

為了讓應用正常運作,Ionic 2 會在HTML中尋找 <ion-app> 標記。 在這個例子中,我們有:

<ion-app></ion-app>

並且在下方我們還能看到這樣的腳本引用:

<script src="cordova.js"></script>

  <script src="build/polyfills.js"></script>

  <script src="build/main.js"></script>

•  cordova.js 是Cordova應用的需求文件,我們在開發過程中這個文件將會提示404錯誤,這不需要擔心。Cordova將會在構建過程中自動注入這個文件。

•  build/polyfills.js 是在構建過程中自動生成的,我們不需要過多關注。

build/main.js 是一個包含了Ionic, Angular和你的JS腳本的文件。

 

./src/app/app.component.ts

在 app 文件夾中能找到我們的預編譯代碼。這是Ionic 2應用程序的大部分工作起始的地方。當我們運行 ionic serve 時, app 中的代碼將被編譯成當前瀏覽器能夠執行的JavaScript版本(當前是ES5)。也就是說我們可以使用TypeScript或更高級別的 ES6+ 進行開發,而在編譯時會自動降級為瀏覽器可識別的版本。

app.component.ts 是應用的入口文件。

在文件中我們能夠看到這樣的結構:

@Component({

  templateUrl: 'app.html'

})

export class MyApp {

  constructor(

  )

}

每個應用程序都有一個根組件,用於控制應用程序的其余部分。這跟Ionic 1和Angular 1中的 ng-app 非常相似。原先的啟動配置被放倒了app.module.ts 文件中。

在這個組件中,我們設置了模版文件 app.html,下面我們來看一下這個文件。

./src/app/app.html

app.html 里是我們應用的主模版:

<ion-menu [content]="content">   <ion-header>     <ion-toolbar>       <ion-title>Menu</ion-title>     </ion-toolbar>   </ion-header>
  <ion-content>     <ion-list>       <button menuClose ion-item*ngFor="let p of pages" (click)="openPage(p)">         {{p.title}}       </button>     </ion-list>   </ion-content> </ion-menu>

<!-- Disable swipe-to-go-back because it's poor UX to combine STGB with sidemenus --> <ion-nav [root]="rootPage" #content swipeBackEnabled="false"></ion-nav>

 

在這個模板中,我們設置了一個 ion-menu 作為側面菜單,然后一個 ion-nav 組件作為主要內容區域。 ion-menu 菜單的 [content] 屬性綁定到了我們 ion-nav 的本地變量 content 上。所以我們知道哪里會發生動作變化。

接下來,我們來看看如何創建更多頁面並執行基本的導航。

添加頁面

現在我們對Ionic 2應用的布局有一個基本的掌握,讓我們來了解一下在應用中創建和導航到頁面的過程。

讓我們看一下 app.html 頁面的底部:

<ion-nav [root]="rootPage" #content swipeBackEnabled="false"></ion-nav>

注意 [root] 屬性綁定。 這本質上是設置了ion-nav組件的“root”頁面。 當ion-nav加載時,變量 rootPage 引用的組件將是根頁面。

在 app.component.ts 中, MyApp 組件在其構造函數中指定:

import { Component, ViewChild } from '@angular/core';
import { Nav, Platform } from 'ionic-angular';
import { StatusBar, Splashscreen } from 'ionic-native';

import { Page1 } from '../pages/page1/page1';
import { Page2 } from '../pages/page2/page2';


@Component({
  templateUrl: 'app.html'
})
export class MyApp {
  @ViewChild(Nav) nav: Nav;

  rootPage: any = Page1;

  pages: Array<{title: string, component: any}>;

  constructor(public platform: Platform) {
    this.initializeApp();

    // used for an example of ngFor and navigation
    this.pages = [
      { title: 'Page One', component: Page1 },
      { title: 'Page Two', component: Page2 }
    ];
  }
  initializeApp() {
    this.platform.ready().then(() => {
      // Okay, so the platform is ready and our plugins are available.
      // Here you can do any higher level native things you might need.
      StatusBar.styleDefault();
      Splashscreen.hide();
    });
  }
  openPage(page) {
    // Reset the content nav to have just this page
    // we wouldn't want the back button to show in this scenario
    this.nav.setRoot(page.component);
  }
}

我們看到 rootPage設置成了 Page1,所以 Page1將是在nav控制器中加載的第一個頁面。

而page1指向的頁面是import { Page1 } from '../pages/page1/page1';

創建一個頁面

接下來,讓我們看看我們正在導入的 Page1。在 src/ pages/page1/page1 文件夾中,找到並打開 page1.ts 。

你可能已經注意到每個頁面都有自己的文件夾,該文件夾以頁面命名。 在每個文件夾內,我們還可以看到一個.html和一個.scss同名文件。 例如,在 page1 / 我們將找到 page1.ts , page1 html 和 page1.scss 。 雖然使用這種模式不是必需的,但它可以有助於保持項目的組織結構。

然后我們找到 page1類,在創建的頁面中提供了一個Angular組件和已經使用Ionic的導航系統加載的所有Ionic指令。注意,如果頁面是動態加載的,那么它們沒有選擇器( selector ):

import { Component } from '@angular/core';
import { NavController } from 'ionic-angular';
@Component({
  selector: 'page-page1',
  templateUrl: 'page1.html'
})
export class Page1 {
  constructor(public navCtrl: NavController)  
 }
}

所有的頁面都會有一個類和一個關聯的模版。讓我們再看一下 src/ pages/ page1/ page1.html ,這是一個模版頁面:

<ion-header>
  <ion-navbar>
    <button ion-button menuToggle>
      <ion-icon name="menu"></ion-icon>
    </button>
    <ion-title>Page One</ion-title>
  </ion-navbar>
</ion-header>

<ion-content padding>
  <h3>Ionic Menu Starter</h3>

  <p>
    If you get lost, the <a href="http://ionicframework.com/docs/v2">docs</a> will show you the way.
  </p>

  <button ion-button secondary menuToggle>Toggle Menu</button>
</ion-content>

<ion-navbar>是這個頁面中導航欄的模版。當我們導航到這個頁面,導航欄的按鈕和標題作為頁面轉換的一部分進行過渡。

模板的其余部分是標准的Ionic代碼,用於設置我們的內容區域並輸出我們的歡迎信息。

創建其他頁面

要創建一個其他的頁面,我們不需要太多的事情,只要確保配置標題和我們期望在導航欄顯示的東西即可。

讓我們來看一下 src/pages/page2/ page2.ts。在這里,你會看到一個新的頁面被定義:

import { Component } from '@angular/core';
import { NavController, NavParams } from 'ionic-angular';
@Component({
  selector: 'page-page2',
  templateUrl: 'page2.html'
})
export class Page2 {
  selectedItem: any;
  icons: string[];
  items: Array<{title: string, note: string, icon: string}>;
  constructor(public navCtrl: NavController, public navParams: NavParams) {
    // If we navigated to this page, we will have an item available as a nav param
    this.selectedItem = navParams.get('item');
    // Let's populate this page with some filler content for funzies
    this.icons = ['flask', 'wifi', 'beer', 'football', 'basketball', 'paper-plane',
    'american-football', 'boat', 'bluetooth', 'build'];

    this.items = [];
    for (let i = 1; i < 11; i++) {
      this.items.push({
        title: 'Item ' + i,
        note: 'This is item #' + i,
        icon: this.icons[Math.floor(Math.random() * this.icons.length)]
      });
    }
  }
  itemTapped(event, item) {
    // That's right, we're pushing to ourselves!
    this.navCtrl.push(Page2, {
      item: item
    });
  }
}

此頁面將創建一個包含多個項目的基本列表頁面。

總的來說,這個頁面和我們之前看到的 Page1非常相似。在下一節中,我們將學習如何導航到新頁面!

導航到頁面

回想上一部分我們在 Page2類中有一個函數,看起來像這樣:

itemTapped(event, item) {   // That's right, we're pushing toourselves!   this.navCtrl.push(Page2, {     item: item   }); }

你可能已經注意到我們引用了一個page2。自己跳到自己,這是一個包含在教程啟動器中的頁面。

保存好之后。你會發現 ionic serve將重新編譯應用程序並刷新瀏覽器,你的修改將會出現在程序中。讓我們在瀏覽器中重新訪問我們的應用程序,當我們點擊一個項目,它將導航到項目詳細信息頁面!請注意,菜單切換按鈕將被替換為后退按鈕。這是Ionic遵循的原生風格,但可以按需配置。

工作原理

Ionic 2導航的工作原理就像一個簡單的堆棧,我們通過push將一個頁面推到堆棧的頂端,這會讓我們的應用前進一步並顯示一個返回按鈕。反之,我們也可以pop掉一個頁面。因為我們在構造函數中設置了this.navCtrl,我們可以調用this.navCtrl.push() ,並傳遞我們要導航到的頁面。我們還可以傳遞一個數據對象給我們想要導航到的頁面。使用push導航到新頁面很簡單,而且Ionic的導航系統非常的靈活。你可以查看導航文檔找到更多高級導航示例。

當涉及到URL,Ionic 2的工作方式有點不同於Ionic 1。不使用URL導航,可以確保我們可以總是回到一個頁面(例如應用程序啟動)。這意味着我們不只是限於使用href來導航。無論怎樣,我們仍然可以選擇在必要時使用網址導航到某個網頁。

•   建議熟悉一下TypeScript的基本語法和使用,包括@types使用和d.ts編寫。

•   掌握Angular2的基本原理和開發思路。

•   熟悉Ionic 2的所有Components和API。

  了解Cordova的使用方法和插件。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM