提交 5eb42e8b 编写于 作者: DCloud-WZF's avatar DCloud-WZF 💬

update: 更新static目录使用说明

上级 80f1c921
......@@ -125,20 +125,35 @@ json的条件编译,如不同平台的key名称相同,cli项目下开发者
### static 目录的条件编译
在不同平台,引用的静态资源可能也存在差异,通过 static 的的条件编译可以解决此问题,static 目录下新建不同平台的专有目录(目录名称同 `%PLATFORM%` 值域,但字母均为小写),专有目录下的静态资源只有在特定平台才会编译进去。
在不同平台,引用的静态资源可能也存在差异,通过 static 的条件编译可以解决此问题,static 目录下新建不同平台的专有目录,
|目录名称|说明|
|:-:|:-:|
|app-plus|App|
|h5|H5|
|mp-weixin|微信小程序|
|mp-alipay|支付宝小程序|
|mp-baidu|百度小程序|
|mp-qq|QQ小程序|
|mp-toutiao|字节小程序|
|mp-lark|飞书小程序|
|mp-kuaishou|快手小程序|
|mp-jd|京东小程序|
专有目录下的静态资源只有在特定平台才会编译进去。
如以下目录结构,``a.png`` 只有在微信小程序平台才会编译进去,``b.png`` 在所有平台都会被编译。
<pre v-pre="" data-lang="">
<code class="lang-" style="padding:0">
┌─static
┌─static
│ ├─mp-weixin
│ │ └─a.png
│ │ └─a.png
│ └─b.png
├─main.js
├─App.vue
├─manifest.json
└─pages.json
├─main.js
├─App.vue
├─manifest.json
└─pages.json
</code>
</pre>
......@@ -148,7 +163,7 @@ json的条件编译,如不同平台的key名称相同,cli项目下开发者
**注意**
- `platforms`目录下只支持放置页面文件(即页面vue文件),如果需要对其他资源条件编译建议使用[static 目录的条件编译](https://uniapp.dcloud.io/platform?id=static-%e7%9b%ae%e5%bd%95%e7%9a%84%e6%9d%a1%e4%bb%b6%e7%bc%96%e8%af%91)
- `platforms`目录下只支持放置页面文件(即页面vue文件),如果需要对其他资源条件编译,建议使用[static 目录的条件编译](https://uniapp.dcloud.net.cn/tutorial/platform.html#static-%E7%9B%AE%E5%BD%95%E7%9A%84%E6%9D%A1%E4%BB%B6%E7%BC%96%E8%AF%91)
### HBuilderX 支持
......@@ -157,7 +172,7 @@ HBuilderX 为 ``uni-app`` 的条件编译提供了丰富的支持:
**代码块支持**
在 HBuilderX 中开发 ``uni-app`` 时,通过输入 **ifdef** 可快速生成条件编译的代码片段
![](https://bjetxgzv.cdn.bspapp.com/VKCEYUGU-uni-app-doc/0a1766f0-4f3c-11eb-8a36-ebb87efcf8c0.png)
**语法高亮**
......
......@@ -31,25 +31,14 @@
├─App.vue 应用配置,用来配置App全局样式以及监听 <a href="/collocation/App#应用生命周期">应用生命周期</a>
├─manifest.json 配置应用名称、appid、logo、版本等打包信息,<a href="/collocation/manifest">详见</a>
├─pages.json 配置页面路由、导航条、选项卡等页面类信息,<a href="/collocation/pages">详见</a>
└─uni.scss 这里是uni-app内置的常用样式变量
└─uni.scss 这里是uni-app内置的常用样式变量
</code>
</pre>
**Tips**
- 编译到任意平台时,`static` 目录下的文件均会被完整打包进去,且不会编译。非 `static` 目录下的文件(vue、js、css 等)只有被引用到才会被打包编译进去。
- `static` 目录下的 `js` 文件不会被编译,如果里面有 `es6` 的代码,不经过转换直接运行,在手机设备上会报错
`static目录` 使用注意
- 编译到任意平台时,`static` 目录下除不满足[条件编译](https://uniapp.dcloud.net.cn/tutorial/platform.html#static-%E7%9B%AE%E5%BD%95%E7%9A%84%E6%9D%A1%E4%BB%B6%E7%BC%96%E8%AF%91)的文件,会直接复制到最终的打包目录,不会打包编译。非 `static` 目录下的文件(vue、js、css 等)只有被引用时,才会被打包编译
- `css``less/scss` 等资源不要放在 `static` 目录下,建议这些公用的资源放在自建的 `common` 目录下。
- HbuilderX 1.9.0+ 支持在根目录创建 `ext.json``sitemap.json` 等小程序需要的文件。
|有效目录|说明|
|:-:|:-:|
|app-plus|App|
|h5|H5|
|mp-weixin|微信小程序|
|mp-alipay|支付宝小程序|
|mp-baidu|百度小程序|
|mp-qq|QQ小程序|
|mp-toutiao|字节小程序|
|mp-lark|飞书小程序|
|mp-kuaishou|快手小程序|
|mp-jd|京东小程序|
**Tips**
- HbuilderX 1.9.0+ 支持在根目录创建 `ext.json``sitemap.json` 等小程序需要的文件。
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册