于ionic2的跨平台项目（一）简单探讨及iOS项目创建

基于ionic2的跨平台项目探讨（iOS）

一、     技术背景

为了开发html5，除了最新使用React Native等之外，目前首选稳定的ionic+Angularjs来开发iOS 和Android。

        Ionic是一款可以使用html5构建混合移动应用的用户界面框架，它自称是“本地与html5的结合”。该框架提供了很多

基本的移动用户界面范例，例如像列表（lists）、标签页栏（tabbars）和触发开关（toggleswitches）这样的简单条目

。它还提供了更加复杂的可视化布局示例，例如在下面显示内容的滑出式菜单。

Cordova是一款开放源代码的App开发框架，旨在让开发者使用HTML、Javascript、CSS等WebAPIs开发跨平台的移动平

台应用程序，其原名称之为PhoneGap，Adobe收购Nitobi公司后，PhoneGap商标保留，代码贡献给了Apache基金会，而A

pache将其命名为ApacheCallback，其后发布新版本时，定名为ApacheCordova。

Cordova是一个行动设备的API接口集，利用JavaScript存取这些接口可以调用诸如摄影机、罗盘等硬件系统资源。配合上

一些基于HTML5、CSS3技术的UI框架，如jQueryMobile、DojoMobile或SenchaTouch，开发者得以快速地开发跨平台App

而不需要编写任何的原生代码，因为Cordova本身仍是一个原生程式，为App打包时依然需要用到这些系统平台的SDK。

二、     环境搭建

安装npm、node.js

打开终端，可分别输入以下内容查看npm和node的版本号：

$ npm –v
$ node–v

如果npm或者node并非最新版本或者没有安装,可以到nodejs官网下载最新版本，下载好后双击下载的pkg包默认安装即可。

安装ionic和cordova

采用淘宝npm镜像避免国内网络安装错误，终端输入：

$ sudo npm set registry https://registry.npm.taobao.org
下载后安装ionic和cordova包，终端输入：

$ sudo npm install -g cordova ionic

安装成功后，查看安装的包内容是否全部都已安装，终端输入：

$ ionic info

根据信息提示，可对未成功安装的包再次安装。

三、     项目生成

进入桌面（或其他文件夹路径），终端输入：

$ cd ./Desktop

生成demo004文件项目，终端输入：

$ ionic start myapp（项目名称） --v2

ps：可以在项目名称后加上不同参数（blank、tabs、sidemenu）， 其中blank等参数是几种app样式，可根据需要选择不

同参数，不写的话默认是tabs样式；--v2是指按照ionic2的版本来创建项目，如果不写--v2则会创建ionic1项目。

创建成功后，项目文件夹如图。

一般使用浏览器作为调试工具，cd到项目文件夹，终端输入：

$ cd myapp
$ ionic serve

执行完毕后Ionic会自动帮我们打开我们的默认浏览器并跳转到我们的应用页面，浏览器打开页面时Ionic已经给我们开启

了livereload模式，开启之后我们编辑www下的文件后保存时Ionic会通过websocket通知浏览器刷新页面，我们就不用每

次修改完毕手动刷新页面了。

Ionic支持两个平台iOS、Android，默认的Ionic项目并没有添加这两个平台，我们需要手动添加，终端输入：

$ ionic platform add android
$ ionic platform add ios

可以查看你已经添加的平台列表，终端输入：

$ ionic platform list

安装ios模拟器，终端输入：

$ npm install -g ios-sim

安装好后，cd到项目目录后，开始编译项目，终端输入：

$ ionic build ios

运行项目可以使用Xcode，也可以使用终端，终端输入：

$ ionic run ios

稍等片刻，app就生成好了。如下图：

四、     项目结构

在我们创建的文件夹中，可以看到一个典型的Cordova项目结构。

src/index.html是 Ionic 2 应用的主入口文件，其目的是设置脚本和CSS引导，然后开始运行我们的应用程序。 我们不会在这个文件中花费大量的时间。

src/app/app.component.ts在该文件能找到我们的预编译代码。这是Ionic 2应用程序的大部分工作起始的地方。当我们运行 

ionic serve 时， app 中的代码将被编译成当前浏览器能够执行的JavaScript版本（当前是ES5）。也就是说我们可以使用

TypeScript或更高级别的 ES6+ 进行开发，而在编译时会自动降级为浏览器可识别的版本。

在文件中我们能够看到这样的结构：

@Component({

  templateUrl: 'app.html'

})

export class MyApp {

  constructor(

  )

}

每个应用程序都有一个根组件，用于控制应用程序的其余部分。在这个组件中，我们设置了模版文件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>

      <buttonmenuClose ion-item*ngFor="let p of pages"(click)="openPage(p)">

       {{p.title}}

     </button>

    </ion-list>

  </ion-content>

</ion-menu>

 

<!-- Disable swipe-to-go-back becauseit's poor UX to combine STGB with sidemenus -->

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

在这个模板中，我们设置了一个 ion-menu 作为侧面菜单，然后一个 ion-nav 组件作为主要内容区域。 ion-menu 菜单的 [c

ontent] 属性绑定到了我们 ion-nav 的本地变量 content 上。所以我们知道哪里会发生动作变化。

src/pages是包含所有页面的文件夹，也是用来实现业务逻辑的区域，推荐使用html、scss、ts文件各司其职的方式（如下

图），将会使开发思路更清晰。

五、     示例

自己做一个简单demo，测试一下调用本地相册功能，以及ts代码和ios原生代码的交互方式。

1.      在src/pages/home.html中加入如下代码：

  <button (click)="openCamera()"ion-button color="secondary">选取照片</button>

  <button (click)="addObserver()"ion-button color="secondary">监听原生页面通知</button>

  <button (click)="toApplePage()"ion-button color="secondary">跳转到原生页面</button>

2.      安装插件，终端输入：

$ cordova plugin add cordova-plugin-camera

$ cordova plugin add cordova-plugin-broadcaster

3.      创建detail页面文件夹，终端输入

$ ionic g page detail

4.      在src/pages/home.ts中，导入依赖的组件：

import{ Camera } from 'ionic-native';

import{ NavController } from 'ionic-angular';

import{ DetailPage } from '../detail/detail';

import{ Broadcaster } from 'ionic-native'

其中Camera模块用来实现打开相册，NavController和DetailPage模块用来实现界面导航和跳转，Broadcaster用来实现与原生代码的交互。

5.      实现openCamera方法，加入如下代码，至此，打开相册功能完成：

      var options = {

      quality: 50,

      destinationType:Camera.DestinationType.FILE_URI,

     sourceType:0,//0对应打开相册

      encodingType: Camera.EncodingType.JPEG,

      mediaType: Camera.MediaType.PICTURE,

      allowEdit: true,

      correctOrientation: true

    }

              Camera.getPicture(options).then((imageData)=> {

                        letbase64Image =  imageData;

                        alert(base64Image);

    });

6.      实现addObserver方法，加入如下代码：

Broadcaster.addEventListener('nativeToJs').forEach(() =>this.navCtrl.push(DetailPage))

7.      实现toApplePage方法，加入如下代码：

Broadcaster.fireNativeEvent('jsToNative',{ item:'test data'}).then(() => console.log('Success'));

8.      接下来打开Xcode，去编辑原生代码的部分；在自动生成的MainViewController的viewDidLoad方法中加入如下代码

，目的是在加载首页界面后，让通知中心监听ts代码发来的消息：

[[NSNotificationCenter defaultCenter] addObserverForName:@"jsToNative" object:nil queue:[NSOperationQueue mainQueue] usingBlock:^(NSNotification * _Nonnull note) {

NSLog(@"handledjs to native [%@]", note.userInfo[@"item"]);

UIViewController*vc = [[RedViewController alloc] init];

[self presentViewController: [[UINavigationController alloc]initWithRootViewController:vc] animated:true completion:nil];

}];

9.      在子页面中添加一个返回按钮，实现其点击方法：

-(void)btnClick {

NSDictionary*userInfo = @{@"key": @"value"};

[self dismissViewControllerAnimated:true completion:^{

    [[NSNotificationCenter defaultCenter] postNotificationName:@"nativeToJs" object:nil userInfo: userInfo];

    }];

}

10.      完成全部功能。

六、     总结

通过一段时间学习，感觉Ionic作为一个hybrid应用的开发框架总体来说还是很不错的，因为它的开发效率很高，并且可

以跨平台发布；缺点是目前网上关于ionic尤其是ionic2以及ionic2使用的typescript的学习探讨资料比较少，关于实际开发

、打包发布等方面恐怕难免有坑。但是，作为未来趋势，绝对有学习的必要，以下推荐学习内容：建议熟悉一下TypeScr

ipt的基本语法和使用；掌握Angular2的基本原理和开发思路；熟悉Ionic 2的所有Components和API（参见https://ionicfram

ework.com/docs/）；了解Cordova的使用方法和插件。

项目地址：https://github.com/gaoqh/Ionic2-jsToNative