uniapp项目中打包成PC-Web或者H5需要注意点

uni-app项目在HbuilderX中打包成PC-Web或H5需要注意:

1.在manifest.js中指定appid,https://dev.dcloud.net.cn中自己账号下的应用appid,

 "appid" : "__UNI__XXXXX",//如果不指定,打包H5会失败

2.在auth.js中指定访问后端的地址或是域名

baseURL: `http://10.10.10.66:8080/prod-api`,
localURL: `http://10.10.10.66:8080`,
### 使用 UniApp 进行 H5 打包的教程和配置方法 #### 1. 设置 AppID 在项目根目录下的 `manifest.json` 文件中,找到并设置项目的 **AppID**。需要注意的是,该 AppID 是整个项目的唯一标识符,而不是团队员个人的 AppID[^1]。 #### 2. 路由模式配置 默认情况下,UniApp 的路由模式为 hash 模式(即 URL 中带有 `#` 符号)。如果需要更友好的路径结构,可以切换到 history 模式。 修改方式如下: 打开 `pages.json` 文件,在全局配置部分添加以下字段: ```json { "globalStyle": { "navigateStyle": "history" } } ``` 此操作会启用 HTML5 History 模式的路由支持[^2]。 > 注意:当使用 history 模式时,服务器需配合进行重写规则配置,否则可能会出现页面刷新后 404 错误的情况。 #### 3. 打包流程 ##### (1) CLI 工具打包 通过命令行工具完 H5 打包,具体步骤如下: 安装依赖环境后运行以下命令: ```bash npm run build:h5 ``` 如果遇到错误提示 “找不到接受实际参数‘--platform’的位置形式参数”,可能是由于版本兼容问题引起的,请确认当前使用的 CLI 版本是否最新。 ##### (2) HBuilderX 图形化界面打包 对于不熟悉命令行操作的开发者,可以直接利用官方 IDE —— HBuilderX 完打包工作: 进入菜单栏中的「发行」选项卡 -> 「网站-PCH5...-> 填写必要的发布信息 -> 单击「发行」按钮即可生目标文件夹。 #### 4. Nginx 部署与路径配置 为了使打包后的静态资源能够正常访问,通常会选择将其托管至 Web 服务程序上,比如 Nginx。以下是基于 Nginx 的典型配置案例: 编辑站对应的虚拟主机配置文件,增加如下内容: ```nginx location /h5/ { alias /www/data/html/h5/; try_files $uri $uri/ /index.html; index index.html index.htm; } ``` 上述片段定义了一个名为 `/h5/` 的子路径映射关系,并确保即使请求不存在的具体文件也能回退加载首页入口文件 `index.html`[^3]。 --- ### 示例代码展示 假设我们有一个简单的 Vue 组件用于测试功能,则其可能的内容如下所示: ```vue <template> <div id="app"> Hello, this is a test page. </div> </template> <script> export default { name: 'TestPage', }; </script> ``` 执行完以上全部步骤之后,您应该已经功完了从开发调试直至上线部署的一整套过程! ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值