Angular4+Ionic3-企业微信应用开发

Posted 2023-04-22

参考技术A Angular4+Ionic3-企业微信应用开发

一、搭建Ionic3项目工程

（1）、配置环境：

node安装：参照node官网（ http://nodejs.cn/download/ ）

cnpm淘宝镜像安装：

npm install -g cnpm --registry=https://registry.npm.taobao.org

ionic安装：cnpm install -g ionic

（2）、创建项目：

创建带tab栏项目：Ionic start project tabs

创建空白页项目：Ionic start project blank

（3）、运行项目：

安装依赖：cnpm install

启动项目：ionic serve

二、企业微信应用开发步骤

（1）、企业微信API：

    推荐参考： https://work.weixin.qq.com/api/doc#90000/90003/90556

（2）、具体开发

    1、项目目录构成

    2、引入企业微信相关文件

    a、在index.html页面，引入微信的js文件。

    b、因项目使用的是亚马逊的服务器，所以要在开发企业微信时，需要使用由API Gateway 为 REST API 生成的 javascript 开发工具包（此包是由后端生成，前端引用），从后端处获取到JavaScript包后，放置在assets文件夹下，在index.html页面中一一引入这些js文件。

    c、从后端处获取的js文件，给改文件下的config加上accessKey和secretKey。

    3、调用企业微信API的文件配置

        在app文件夹下，新建一个d.ts文件，在该文件下定义全局的变量，例如wechat.d.ts，具体如下：

        配置完成后，可在具体页面中进行企业微信API的调用，例如监听页面返回操作：

    4、获取code

    在index.html页面，使用缓存的方式存储code，如下：

    5、在app.component.ts文件下，调用从后端获取的api文件下的方法，获取token、个人信息等等，以下就是怎么调用后端企业微信接口，获取token、个人信息，在本项目中，所调用的接口全部是取自后端集成的JavaScript包。

三、开发中遇到的一些问题

（1）、集成js-sdk失败的问题，出现invalid signature签名抛错。

    处理：是URL的问题，根据js-sdk上面签名算法的生成上，URL参数是为解码后的URL，后端没解码URL，所以导致签名抛错，前端传给后端是通过encodeURIComponent()方法转码过后的URL，而后端拿到前端转码过后的URL，是需要解码才能生成正确的签名。

Ionic01 简单介绍环境搭建创建项目项目结构创建组件创建页面子页面跳转

 

1 Ionic 基本介绍

　　Ionic 是一款基于 Angular、Cordova 的强大的 HTML5 移动应用开发框架 , 可以快速创建一个跨平台的移动应用。可以快速开发移动 App、移动端 WEB 页面、微信公众平台应用，混
合 appweb 页面。

　　Ionic官网

　　1.1 ionic、cordova、angular之间的关系

　　　　ionic=Cordova+Angular+ionicCSS

　　　　Ionic 是完全基于谷歌的 Angular 框架，在 Angular 基础上面做了一些封装，让我们可以更快 速和容易的开发移动的项目。Ionic 调用原生的功能是基于 Cordova,Cordova 提供了使用 JavaScript 调用 Native 功能，ionic 自己也封装了一套漂亮的 CSSUI 库。

 

2 Ionic环境搭建

　　2.1 安装Node.js

　　　　详情参见度娘

　　　　技巧01：安装完node.js后就可以使用npm命令了

　　　　　　

　　2.2 安装 cordova、ionic

　　　　技巧01：利用 npm 安装cordova和ionic，如果安装失败请换cnpm进行安装

　　　　技巧02：使用cnpm前需要利用npm进行安装    ->    npminstall-gcnpm--registry=https://registry.npm.taobao.org

npm install -g cordova ionic

 　　　　　　

　　2.3 开发工具

　　　　2.3.1 webstorm

　　　　　　功能强大，就是有点卡

　　　　2.3.2 vsCode

　　　　　　angular官方推荐，原因你懂的

 

3 新建Ionic项目

　　使用 ionic start 命令来创建应用。可以选择创建一个空白的应用，或是基于已有的模板来创建应用；ionic start 命令的第一个参数是应用的名称，会作为包含生成的骨架代码的目录的名称；第二个参数是模板的名称。Ionic 默认提供了7种模板。这些模板也可能随着 Ionic 的版本升级而不断变化。

ionic start 项目名称 项目模板

　　技巧01：项目创建完毕后，进入到新建项目的根目录执行 ionic serve 就可以启动项目【PS: 和angualr类似，仅仅更换了关键字而已】

》空白应用：模板名称为 blank。生成的应用是空白的，适合于已有经验的开发人员。
》底部标签式应用：模板名称为 tabs。生成的应用的底部是一个标签页，每个标签可以有自己的页面。
》带侧边栏菜单的应用：模板名称为 sidemenu。生成的应用的左上角是一个可以打开侧边栏菜单的按钮。也可以通过手指向右滑动来打开侧边栏。
》超级完整版的应用：模板名称为 super。生成的应用非常完备，包含了很多作为示例的页面。建议初学者从这些页面中学习 Ionic 应用开发的最佳实践。
》会议应用：模板名称为 conference。这是一个完整的、现实世界中的、使用 Ionic 开发的会议日程相关的应用。
》教程应用：模板名称为 tutorial。这是与 Ionic 官方教程相对应的模板。
》AWS Mobile 应用：模板名称为 aws。这是使用 AWS Mobile 作为后台的应用模板。

 

4 目录结构分析

hooks：编译 cordova 时自定义的脚本命令，方便整合到我们的编译系统和版本控制系统中 node_modules ：node 各类依赖包 
resources ：android/ios 资源（更换图标和启动动画） 
src：开发工作目录，页面、样式、脚本和图片都放在这个目录下 
www：静态文件 
platforms：生成 android 或者 ios 安装包路径（ platformsandroiduildoutputsapk：apk 所在位置）执行 cordova platform add android 后会生成
plugins：插件文件夹，里面放置各种 
cordova 安装的插件 
config.xml: 打包成 app 的配置文件 
package.json: 配置项目的元数据和管理项目所需要的依赖 
tsconfig.json: TypeScript 项目的根目录，指定用来编译这个项目的根文件和编译选项 tslint.json：格式化和校验 typescript

　　4.1 src文件详解

app：应用根目录 
assets：资源目录（静态文件（图片，js 框架。。。）
pages：页面文件，放置编写的页面文件，包括：html，scss，ts。 
theme：主题文件，里面有一个 scss 文件，设置主题信息。

　　　　

 

5 创建组件

　　5.1 ionic 创建命令组件

　　　　技巧01：在项目根目录下执行相关命令可以查看ionic支持创建哪些命令

ionic generate --help 

　　　　　　

　　5.2 创建组件

　　　　技巧01：创建第一个组件时会自动生成一个组件模块，并将新创建的组件添加到这个模块中；之后创建的模块都会添加到这个模块中（即：所有的组件都从属与这个模块）；直接将这个模块在主模块中进行引入并声明就可以在任何地方使用了。

ionic generate component 组件名称

　　5.3 引入并声明组件

　　　　

import { NgModule, ErrorHandler } from ‘@angular/core‘;
import { BrowserModule } from ‘@angular/platform-browser‘;
import { IonicApp, IonicModule, IonicErrorHandler } from ‘ionic-angular‘;
import { MyApp } from ‘./app.component‘;

import { AboutPage } from ‘../pages/about/about‘;
import { ContactPage } from ‘../pages/contact/contact‘;
import { HomePage } from ‘../pages/home/home‘;
import { TabsPage } from ‘../pages/tabs/tabs‘;

import { StatusBar } from ‘@ionic-native/status-bar‘;
import { SplashScreen } from ‘@ionic-native/splash-screen‘;
import { ComponentsModule } from ‘../components/components.module‘;

@NgModule({
  declarations: [
    MyApp,
    AboutPage,
    ContactPage,
    HomePage,
    TabsPage
  ],
  imports: [
    BrowserModule,
    ComponentsModule,
    IonicModule.forRoot(MyApp)
  ],
  bootstrap: [IonicApp],
  entryComponents: [
    MyApp,
    AboutPage,
    ContactPage,
    HomePage,
    TabsPage
  ],
  providers: [
    StatusBar,
    SplashScreen,
    {provide: ErrorHandler, useClass: IonicErrorHandler}
  ]
})
export class AppModule {}

View Code

　　5.4 使用组件

　　　　技巧01：和angular中使用组件的方式一样，只要在相应模块中引入并声明后就可以使用了【PS: 本博文直接将需要使用组件所在的模块引入的】

　　　　》在home页面中使用

　　　　　　技巧01：页面也相当于一个组件

<ion-header>
  <ion-navbar>
    <ion-title>Home</ion-title>
  </ion-navbar>
</ion-header>

<ion-content padding>
  <h2>Welcome to Ionic!</h2>
  <p>
    This starter project comes with simple tabs-based layout for apps
    that are going to primarily use a Tabbed UI.
  </p>
  <p>
    Take a look at the <code>src/pages/</code> directory to add or change tabs,
    update any existing page or create new pages.
  </p>
  <hr/>
  <div>
    <news></news>
  </div>
</ion-content>

View Code

　　5.5 组件采坑

　　　　5.5.1 问题

　　　　　　在新创建的组件中直接使用angular相关的指令时会报错，例如：使用*ngFor指令的错误信息如下 ，意思是：li命令没有*ngFor这个属性

　　5.5.2 解决

　　　　在组件所在模块中引入并声明  BrowserModule 模块即可

import { NgModule } from ‘@angular/core‘;
import { NewsComponent } from ‘./news/news‘;
import { BrowserModule } from ‘@angular/platform-browser‘;

@NgModule({
    declarations: [NewsComponent],
    imports: [
        BrowserModule
    ],
    exports: [NewsComponent]
})
export class ComponentsModule {}

View Code

 

 6 创建页面及页面跳转

　　6.1 创建页面

　　　　技巧01：创建页面时，会自动为每个页面创建一个模块

 ionic generate page 页面名

　　6.2 页面引入和声明

　　　　技巧01：新创建的页面必须在跟模块中进行引入和声明后才可以使用

import { NgModule, ErrorHandler } from ‘@angular/core‘;
import { BrowserModule } from ‘@angular/platform-browser‘;
import { IonicApp, IonicModule, IonicErrorHandler } from ‘ionic-angular‘;
import { MyApp } from ‘./app.component‘;

import { AboutPage } from ‘../pages/about/about‘;
import { ContactPage } from ‘../pages/contact/contact‘;
import { HomePage } from ‘../pages/home/home‘;
import { TabsPage } from ‘../pages/tabs/tabs‘;

import { StatusBar } from ‘@ionic-native/status-bar‘;
import { SplashScreen } from ‘@ionic-native/splash-screen‘;
import { ComponentsModule } from ‘../components/components.module‘;
import { NewsPage } from ‘../pages/news/news‘;

@NgModule({
  declarations: [
    MyApp,
    AboutPage,
    ContactPage,
    HomePage,
    TabsPage,
    NewsPage
  ],
  imports: [
    BrowserModule,
    ComponentsModule,
    IonicModule.forRoot(MyApp)
  ],
  bootstrap: [IonicApp],
  entryComponents: [  // 不需要在模板中使用时需要进行的声明
    MyApp,
    AboutPage,
    ContactPage,
    HomePage,
    TabsPage,
    NewsPage
  ],
  providers: [
    StatusBar,
    SplashScreen,
    {provide: ErrorHandler, useClass: IonicErrorHandler}
  ]
})
export class AppModule {}

View Code

　　6.3 页面跳转

　　　　技巧01：在tabs页面中按照套路修改ts文件和模板文件就行啦　　　

import { Component } from ‘@angular/core‘;

import { AboutPage } from ‘../about/about‘;
import { ContactPage } from ‘../contact/contact‘;
import { HomePage } from ‘../home/home‘;
import { NewsPage } from ‘../news/news‘;

@Component({
  templateUrl: ‘tabs.html‘
})
export class TabsPage {

  tab1Root = HomePage;
  tab2Root = AboutPage;
  tab3Root = ContactPage;
  tab4Root = NewsPage;

  constructor() {

  }
}

TS

<ion-tabs>
  <ion-tab [root]="tab1Root" tabTitle="Home" tabIcon="home"></ion-tab>
  <ion-tab [root]="tab2Root" tabTitle="About" tabIcon="information-circle"></ion-tab>
  <ion-tab [root]="tab3Root" tabTitle="Contact" tabIcon="contacts"></ion-tab>
  <ion-tab [root]="tab4Root" tabTitle="News" tabIcon="apps"></ion-tab>
</ion-tabs>

HTML

　　6.4 效果展示

　　　　

 

7 子页面跳转

　　技巧01：从一个页面跳转到子页面可以利用依赖注入的 NavController 实现

　　技巧02：子页面必须在根模块中进行引入和声明

import { Component } from ‘@angular/core‘;
import { IonicPage, NavController, NavParams } from ‘ionic-angular‘;
import { NewsInfoPage } from ‘../news-info/news-info‘;

/**
 * Generated class for the NewsPage page.
 *
 * See https://ionicframework.com/docs/components/#navigation for more info on
 * Ionic pages and navigation.
 */

@IonicPage()
@Component({
  selector: ‘page-news‘,
  templateUrl: ‘news.html‘,
})
export class NewsPage {

  newsList : string[] = [];

  constructor(public navCtrl: NavController, public navParams: NavParams) {
  }

  ionViewDidLoad() {
    console.log(‘ionViewDidLoad NewsPage‘);
    for(let i = 0; i < 10; i++) {
      this.newsList.push("这是第" + i + "新闻");
    }
  }

  onNewsInfoPage(event: Event): void {
    console.log(event);
    this.navCtrl.push(NewsInfoPage);
  }

}

View Code

　　7.1 隐藏tabs菜单

　　　　7.1.1 需求

　　　　　　当跳转到子页面后，将tabs菜单隐藏掉

　　　　7.1.2 解决

　　　　　　直接在根模块中对 IonicModule.forRoot() 进行相应的配置即可

import { NgModule, ErrorHandler } from ‘@angular/core‘;
import { BrowserModule } from ‘@angular/platform-browser‘;
import { IonicApp, IonicModule, IonicErrorHandler } from ‘ionic-angular‘;
import { MyApp } from ‘./app.component‘;

import { AboutPage } from ‘../pages/about/about‘;
import { ContactPage } from ‘../pages/contact/contact‘;
import { HomePage } from ‘../pages/home/home‘;
import { TabsPage } from ‘../pages/tabs/tabs‘;

import { StatusBar } from ‘@ionic-native/status-bar‘;
import { SplashScreen } from ‘@ionic-native/splash-screen‘;
import { ComponentsModule } from ‘../components/components.module‘;
import { NewsPage } from ‘../pages/news/news‘;
import { NewsInfoPage } from ‘../pages/news-info/news-info‘;

@NgModule({
  declarations: [
    MyApp,
    AboutPage,
    ContactPage,
    HomePage,
    TabsPage,
    NewsPage,
    NewsInfoPage
  ],
  imports: [
    BrowserModule,
    ComponentsModule,
    // IonicModule.forRoot(MyApp) // 默认配置
    IonicModule.forRoot(MyApp, {
      tabsHideOnSubPages: "true" // 进入子页面后隐藏tabs菜单配置
    })
  ],
  bootstrap: [IonicApp],
  entryComponents: [  // 不需要在模板中使用时需要进行的声明
    MyApp,
    AboutPage,
    ContactPage,
    HomePage,
    TabsPage,
    NewsPage,
    NewsInfoPage
  ],
  providers: [
    StatusBar,
    SplashScreen,
    {provide: ErrorHandler, useClass: IonicErrorHandler}
  ]
})
export class AppModule {}

View Code

　　7.2 返回按钮配置

　　　　7.2.1 需求

　　　　　　修改子页面的分返回按钮提示信息

　　　　7.2.2 解决

　　　　　　直接在根模块中对 IonicModule.forRoot() 进行相应的配置即可

import { NgModule, ErrorHandler } from ‘@angular/core‘;
import { BrowserModule } from ‘@angular/platform-browser‘;
import { IonicApp, IonicModule, IonicErrorHandler } from ‘ionic-angular‘;
import { MyApp } from ‘./app.component‘;

import { AboutPage } from ‘../pages/about/about‘;
import { ContactPage } from ‘../pages/contact/contact‘;
import { HomePage } from ‘../pages/home/home‘;
import { TabsPage } from ‘../pages/tabs/tabs‘;

import { StatusBar } from ‘@ionic-native/status-bar‘;
import { SplashScreen } from ‘@ionic-native/splash-screen‘;
import { ComponentsModule } from ‘../components/components.module‘;
import { NewsPage } from ‘../pages/news/news‘;
import { NewsInfoPage } from ‘../pages/news-info/news-info‘;

@NgModule({
  declarations: [
    MyApp,
    AboutPage,
    ContactPage,
    HomePage,
    TabsPage,
    NewsPage,
    NewsInfoPage
  ],
  imports: [
    BrowserModule,
    ComponentsModule,
    // IonicModule.forRoot(MyApp) // 默认配置
    IonicModule.forRoot(MyApp, {
      tabsHideOnSubPages: "true", // 进入子页面后隐藏tabs菜单配置
      backButtonText: "返回" // 修改子页面返回按钮文本信息
    })
  ],
  bootstrap: [IonicApp],
  entryComponents: [  // 不需要在模板中使用时需要进行的声明
    MyApp,
    AboutPage,
    ContactPage,
    HomePage,
    TabsPage,
    NewsPage,
    NewsInfoPage
  ],
  providers: [
    StatusBar,
    SplashScreen,
    {provide: ErrorHandler, useClass: IonicErrorHandler}
  ]
})
export class AppModule {}

View Code

　　　　7.2.3 子页面效果图