Angular CLI发布路径的配置项浅析

 更新时间:2021年3月28日 20:00  点击:2496

前言

项目发布总需要根据具体情况配置打包,Angular CLI 提供了方便的打包工具 “ng build”。其中关于发布路径的配置有几样,这里总结汇总它们。

base-href

它指定的是项目构建的目录结构,例如设置为 "deploy-test",最后的打包结果就在 dist/deploy-test 目录下。

项目新建时,在 index.html 下默认是 <base href="/" rel="external nofollow" >,也就是指定这个应用相对根目录运行。这时候,页面的相对路径会基于这个配置,例如 ![](image/test.png) 的实际访问路径是 /image/test.png。

它不会改变资源请求路径:

<body>
 <app-root></app-root>
 <script src="runtime.js"></script>
 <script src="polyfill.js"></script>
 <script src="styles.js"></script>
 <script src="main.js"></script>
</body>

不过我们的项目常常放在一个子目录下运行,例如在 tomcat 的 webapps 下新建一个 “deploy-test” 项目目录。所以相应的,base-href 也要设置为 “/deploy-test/”。

要注意的是,这里的斜杠(/)必不可少,假设服务器子目录叫 “test”,打包部署情况如下:

  • test:如果两头都不加,baseHref 生效,可以获取到资源。但应用生成的浏览器路径错误,为 host:port/test/test#/index,刷新页面会找不到 index.html。
  • /test:只加开头,baseHref 无效,资源相对 host:port 根目录加载,报 404。
  • test/:只加结尾,资源请求路径为 host:port/test/test/XXX.js,报 404。
  • /test/:应用生成路径为 host:port/test/#/index,资源正确加载。

打包时要修改 base-href,主要有三种方式:

  1. 在 index.html 中配置 <base href="XXX" rel="external nofollow" >
  2. 采用 CLI 命令行参数来配置:ng build --baseHref=/XXX/
  3. 在 angular.json 中配置:

 "architect": {
 "build": {
  "builder": "@angular-devkit/build-angular:browser",
  "options": {
  "baseHref": "/kanpm/",
  }
 }
 }

即 baseHref 用以配置应用的部署路径。

deploy-url

如果是将资源和应用放在同一个服务器目录下,baseHref 即可,但是如果资源和应用在不同位置呢?
例如,应用部署在 "/app" 目录下,资源文件放在 ”/app/resource“; 又或者想要通过 cdn(如 cdn.example.com)托管加速应用的各种资源,同时在自己服务器上部署应用本身。

配置 deploy-url 会在打包时修改资源请求路径,例如 --deploy-url=/app/resource/,则最后打包的 index.html 为:

<body>
 <app-root></app-root>
 <script src="/app/resource/runtime.js"></script>
 <script src="/app/resource/polyfill.js"></script>
 <script src="/app/resource/styles.js"></script>
 <script src="/app/resource/main.js"></script>
</body>

又例如有图片 ![](test.png),最后打包后路径就会便变为 ”/app/resource/test.png“。

相应的,它也可以在 angular.json 或者命令行中配置

"architect": {
 "build": {
 "builder": "@angular-devkit/build-angular:browser",
 "options": {
  "deployUrl": "/test/",
 }
 }
}

或者 ng build --deploy-url="/test/"

✨注意:deploy-url 只能修改被打包的资源文件。

样式资源引入

设置了 base-href 之后,样式文件中引入的资源路径的行为在各个 CLI 的版本下会有不同:

  • 2~7 版本下会自动添加 base 路径。例如 url("/assets/path/to/my/asset.png"),会自动在前面叠加 base-href。
  • 8 版本临时新增了 --rebase-root-relative-css-urls=true 命令行参数,可以保持和之前版本行为一致,方便过渡,但是下个版本就废弃。
  • 9 以后的版本,要求使用相对路径来引入资源路径,所以组件中的样式文件引入可以这样写(url("~src/assets/path/to/my/asset.png"))。

因为 baseHref 是一个运行时的值,用以控制 Angular 应用的相对路径。不应该用来处理编译时的打包行为,针对打包的依赖管理,应该由 webpack 通过相对路径去识别,也方便对资源进行额外的处理(例如给资源文件名加上 hash 值,确保不会被缓存)。

✨注意:打包时,会导致需要打包资源会被 webpack 复制一份放入 dist 根目录(assets 文件夹中也还存在一份原版)。所以样式或组件中引入的文件,应该放在 assets 目录外,因为 CLI 创建项目时,angular.json 的默认配置是:

"architect": {
 "build": {
 ...
 "options": {
  "assets": [
  "src/favicon.ico",
  "src/assets",
  ],
 }
}

可以看到,默认配置中,assets 文件夹中的文件,都会不经打包直接复制到 dist 文件夹中(我个人觉得 Nuxt 的目录命名,叫 statics 静态文件夹就更贴切)。需要在组件中 import,或者样式文件中以相对路径引入的文件,就放另一个文件夹,不需要在 angular.jsn 中配置,以免打包后存在重复文件。

总结

我们可以试着把它们配合使用来总结一下:

ng build --prod --base-href="/kanpm/" rel="external nofollow" --deploy-url="/kanpm/resource/"

得到编译打包的 dist/kanpm 文件夹后,我们将所有打包编译的文件都放入服务器 kanpm/resource 目录下,而index.html 和其他直接复制的静态文件,放在服务器 kanpm/ 目录下。请求 host:port/kanpm 就会发现项目就成功运行了!

由此可以看出,base-href 决定的是应用的部署位置,也就是用户通过什么路径能够访问这个网站。而 deploy-url 决定的是打包后的资源文件(图片,字体,js等)被部署在哪里,可以如上示例是应用的子目录下,也可以是某个 cdn 服务器中。

到此这篇关于Angular CLI发布路径配置项的文章就介绍到这了,更多相关Angular CLI发布路径内容请搜索猪先飞以前的文章或继续浏览下面的相关文章希望大家以后多多支持猪先飞!

[!--infotagslink--]

相关文章

  • vue-cli设置publicPath小记

    这篇文章主要介绍了vue-cli设置publicPath小记,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-04-14
  • 如何使用php脚本给html中引用的js和css路径打上版本号

    在搜索引擎中搜索关键字.htaccess 缓存,你可以搜索到很多关于设置网站文件缓存的教程,通过设置可以将css、js等不太经常更新的文件缓存在浏览器端,这样访客每次访问你的网站的时候,浏览器就可以从浏览器的缓存中获取css、...2015-11-24
  • linux中PHP dirname(__FILE__)路径问题解决

    在php 中dirname() 函数返回路径中的目录部分,__FILE__而当前运行文件的完整路径和文件名。如果用在被包含文件中,则返回被包含的文件名。这是一个魔法变量(预定义常量),在...2016-11-25
  • vue-cli 3如何使用vue-bootstrap-datetimepicker日期插件

    这篇文章主要介绍了vue-cli 3如何使用vue-bootstrap-datetimepicker日期插件,帮助大家更好的理解和学习使用vue框架,感兴趣的朋友可以了解下...2021-02-20
  • C#路径,文件,目录及IO常见操作汇总

    这篇文章主要介绍了C#路径,文件,目录及IO常见操作,较为详细的分析并汇总了C#关于路径,文件,目录及IO常见操作,具有一定参考借鉴价值,需要的朋友可以参考下...2020-06-25
  • 详解Vue Cli浏览器兼容性实践

    这篇文章主要介绍了详解Vue Cli浏览器兼容性实践,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-06-09
  • Angular性能优化之第三方组件和懒加载技术

    这篇文章主要介绍了Angular性能优化之第三方组件和懒加载技术,对性能优化感兴趣的同学,可以参考下...2021-05-11
  • 使用C#获取系统特殊文件夹路径的解决方法

    本篇文章是对使用C#获取系统特殊文件夹路径的解决方法进行了详细的分析介绍,需要的朋友参考下...2020-06-25
  • Angular利用HTTP POST下载流文件的步骤记录

    这篇文章主要给大家介绍了关于Angular利用HTTP POST下载流文件的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者使用Angular具有一定的参考学习价值,需要的朋友们下面来一起学习学习吧...2020-07-26
  • 详解基于Vue cli开发修改外部组件Vant默认样式

    这篇文章主要介绍了详解基于Vue cli开发修改外部组件Vant默认样式,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-04-04
  • vue cli4.0项目引入typescript的方法

    这篇文章主要介绍了vue cli4.0项目引入typescript的方法,本文通过示例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2020-07-17
  • Angular处理未可知异常错误的方法详解

    这篇文章主要给大家介绍了关于Angular如何处理未可知异常错误的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-01-17
  • Java实现将图片上传到webapp路径下 路径获取方式

    这篇文章主要介绍了Java实现将图片上传到webapp路径下 路径获取方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-11-12
  • C#使用浏览按钮获得文件路径和文件夹路径的方法

    这篇文章主要介绍了C#使用浏览按钮获得文件路径和文件夹路径的方法,结合实例形式分析了C#浏览器事件响应及文件操作相关技巧,需要的朋友可以参考下...2020-06-25
  • 如何改变R语言默认存储包的路径

    这篇文章主要介绍了改变R语言默认存储包的路径操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2021-05-06
  • 使用Angular CDK实现一个Service弹出Toast组件功能

    本文主要写用cdk实现一个简单的Toast组件,使用的是cdk中的overlay模块,需要手动安装环境,具体安装方法及相关实现代码跟随小编一起看看吧...2021-07-28
  • IOS获取各种文件目录路径的方法

    ios获取文件路径的方法,iphone沙箱模型的四个文件夹,通过documents,tmp,app,Library得到模拟器路径的简单方式,下面小编整理相关资料,把IOS获取各种文件目录路径的方式总结如下,需要的朋友可以参考下...2020-06-30
  • 详解JavaScript的AngularJS框架中的作用域与数据绑定

    这篇文章主要介绍了JavaScript的AngularJS框架中的作用域与数据绑定,包括作用域的继承以及数据的单向和双向绑定等重要知识点,需要的朋友可以参考下...2016-03-07
  • AngularJS的ng-click传参的方法

    本篇文章主要介绍了AngularJS的ng-click传参的方法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧 ...2017-06-24
  • c# 获得当前绝对路径的方法(超简单)

    下面小编就为大家分享一篇c# 获得当前绝对路径的方法(超简单),具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2020-06-25