欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

Angular PWA使用的Demo示例

程序员文章站 2023-09-09 09:52:58
什么是pwa pwa(progressive web app)利用tls,webapp manifests和service workers使应用程序能够安装并离线使用...

什么是pwa

pwa(progressive web app)利用tls,webapp manifests和service workers使应用程序能够安装并离线使用。 换句话说,pwa就像手机上的原生应用程序,但它是使用诸如html5,javascript和css3之类的网络技术构建的。 如果构建正确,pwa与原生应用程序无法区分。

pwa 的主要特点包括下面三点:

  • 可靠 - 即使在不稳定的网络环境下,也能瞬间加载并展现
  • 体验 - 快速响应,并且有平滑的动画响应用户的操作
  • 粘性 - 像设备上的原生应用,具有沉浸式的用户体验,用户可以添加到桌面

pwa 本身强调渐进式,并不要求一次性达到安全、性能和体验上的所有要求,开发者可以通过 pwa checklist 查看现有的特征。

创建项目

step 1.创建项目

我们使用angular cli来创建pwa程序,首先我们安装。

npm install -g @angular/cli
npm install -g @angular/service-worker

首先我们需要确定angular/cli版本在1.6.0或以上。

最新版本6.0.0将无效,应该后续会修复。

.angular-cli.json文件被更名为angular.json

如果是全新项目

可以使用angular/cli帮你创建一个angular service worker项目:

ng new pwcat --service-worker

就这样,cli会帮你安装@angular/service-worker,在.angular-cli.json中启用serviceworker,为app注册serviceworker和生成默认配置的ngsw-config.json

生成的文件中,注意检查一下app.module,ts,其中serviceworkermodule注册的时候应该是这样:

imports: [
  // other modules...
  serviceworkermodule.register('/ngsw-worker.js', {enabled: environment.production})
 ],

在angular 6.0.0中ng new pwcat --service-worker已经被废弃,使用下面的命令为项目添加pwa

ng add @angular/pwa

执行后的结果

create ngsw-config.json (392 bytes)
update angular.json (3464 bytes)
update package.json (1446 bytes)
update src/app/app.module.ts (851 bytes)

如果是已有项目

对于老版本,也就是angular 6.0.0以前:

安装@angular/service-worker:

npm install @angular/service-worker --save

在项目目录下面新增ngsw-config.json文件:

// src/ngsw-config.json
{
 "index": "/index.html",
 "assetgroups": [{
  "name": "app",
  "installmode": "prefetch",
  "resources": {
   "files": [
    "/favicon.ico",
    "/index.html"
   ],
   "versionedfiles": [
    "/*.bundle.css",
    "/*.bundle.js",
    "/*.chunk.js"
   ]
  }
 }, {
  "name": "assets",
  "installmode": "lazy",
  "updatemode": "prefetch",
  "resources": {
   "files": [
    "/assets/**"
   ]
  }
 }]
}

在.angular-cli.json中启用service worker:

// .angular-cli.json
...
{ 
 "apps": [{ 
  ..., 
  "serviceworker": true
 }]
}

然后在app.module.ts中注册service worker :

// src/app.module.ts
...
import { serviceworkermodule } from '@angular/service-worker';
import { environment } from '../environments/environment';
@ngmodule({
 ...
 imports: [
  ... ,
  serviceworkermodule.register('/ngsw-worker.js', { enabled: environment.production })
 ],
})
...

这样项目中就引入service worker。

对于新版本6.0.0

使用下面命令创建。

ng add @angular/pwa

将会创建:
- manifest
- service worker

step 2. 添加angular material模块

安装material和cdk

npm install --save @angular/material @angular/cdk

安装主题

/* src/styles.css */
@import '~@angular/material/prebuilt-themes/deeppurple-amber.css';

安装normalize.css,作用是优化html样式

npm install --save normalize.css

然后在 styles.css中添加:

/* src/styles.css */
@import '~normalize.css/normalize.css';
@import '~@angular/material/prebuilt-themes/deeppurple-amber.css';

添加material module

// src/app/app.module.ts
import { browsermodule } from '@angular/platform-browser';
import { ngmodule } from '@angular/core';
import { mattoolbarmodule } from '@angular/material';
import { appcomponent } from './app.component';
@ngmodule({
 declarations: [ appcomponent ],
 imports: [
  browsermodule,
  mattoolbarmodule
 ],
 providers: [],
 bootstrap: [ appcomponent ]
})
export class appmodule { }

修改app.component.ts和app.component.html

// src/app/app.component.ts
...
export class appcomponent {
 title = 'progressive web cat';
}
<!-- src/app/app.component.html -->
<mat-toolbar color="primary">
 {{ title }}
</mat-toolbar>

step 3.创建一个图片模块

生成模块

ng generate component img-card

将其添加到app.module.ts

// src/app/app.module.ts
...
import { appcomponent } from './app.component';
import { imgcardcomponent } from './img-card/img-card.component';
@ngmodule({
 declarations: [
  appcomponent,
  imgcardcomponent
 ],
 ...

将img-card模块添加到app.component.html中:

<!-- src/app/app.component.html -->
<mat-toolbar color="primary">
 {{title}}
</mat-toolbar>
<app-img-card></app-img-card>

修改app.module.ts

...
@ngmodule({
...
 imports: [
  browsermodule,
  mattoolbarmodule,
  matcardmodule,
  matbuttonmodule
 ],
...
})

修改img-card.component.ts

添加一个全局的catimage类

// src/app/img-card/img-card.component.ts
...
class catimage {
 message: string;
 api: string;
 fontsize: number;
}
...

修改imgcardcomponent

// src/app/img-card/img-card.component.ts
...
export class imgcardcomponent implements oninit {

 private image: catimage = {
  message: 'progressive web cat',
  api: 'https://cataas.com/cat/says/',
  fontsize: 40
 };
 public src: string;
 ngoninit() {
  this.generatesrc();
 }
 generatesrc(): void {
  this.src = this.image.api + this.image.message + 
    '?size=' + this.image.fontsize +
    '&ts=' + date.now();
 }
...

修改img-card.component.html

// src/app/img-card/img-card.component.html
<mat-card>
 <mat-card-actions>
  <button 
   color="primary" 
   (click)="generatesrc()"
   mat-button 
   mat-raised-button>
   give me another cat
  </button>
 </mat-card-actions>
 <img 
  src="{{ src }}" 
  alt="cute cat"
  mat-card-image>
</mat-card>

修改img-card.component.css

// src/app/img-card/img-card.component.css
.mat-card {
 width: 400px;
 margin: 2rem auto;
}
.mat-card .mat-card-actions {
 padding-top: 0;
}
.mat-card .mat-button {
 margin: 0 auto;
 display: block;
}

step 4.离线状态

修改imgcardcomponent

...
disabled = false;
ngoninit() {

  if (navigator.online) {
   this.generatesrc();
  } else {
   this.disabled = true;
   this.src = 'assets/offline.jepg';
  }
}
...

修改`img-card.component.html

<mat-card>
 <mat-card-actions>
  <button 
   color="primary" 
   (click)="generatesrc()"
   mat-button
   disabled="disabled"
   mat-raised-button>
   give me another cat
  </button>
 </mat-card-actions>
 <img 
  src="{{ src }}" 
  alt="cute cat"
  mat-card-image>
</mat-card>

然后构建部署:

ng build --prod

部署

由于https的限制,我们暂时部署到github上。

创建github仓库

上传项目

git add .
git commit -m "upload project to github"
git remote add origin git@github.com:{username}/{repo name}.git
git push --set-upstream origin master

编译

pwcat是仓库名称

ng build --prod --base-href "/pwcat/"

新建github pages分支

git checkout -b "gh-pages"
git push --set-upstream origin gh-pages
git checkout master

部署到github

npm i -g angular-cli-ghpages
ngh "编译的文件夹"

然后在github项目的settings里面github pages选项里设置github pages 分支为gh-pages

此时就可以使用网址https://93alliance.github.io/pwcat/访问了。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。