diff --git a/docs/tutorial/platform.md b/docs/tutorial/platform.md index 094f2b5da7ecfad282fb6bfe32a9b09a53e6f3b6..08de6ff5e45899cd4bed0f704b61322ee7e07b55 100644 --- a/docs/tutorial/platform.md +++ b/docs/tutorial/platform.md @@ -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`` 在所有平台都会被编译。
 	
-┌─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
 	
 
@@ -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) **语法高亮** diff --git a/docs/tutorial/project.md b/docs/tutorial/project.md index 848171750bc9a084a19a476bc6b6b60c64c3d7a1..9804667a26f30ae43c3ff5573bc74c42d245e9e6 100644 --- a/docs/tutorial/project.md +++ b/docs/tutorial/project.md @@ -31,25 +31,14 @@ ├─App.vue 应用配置,用来配置App全局样式以及监听 应用生命周期 ├─manifest.json 配置应用名称、appid、logo、版本等打包信息,详见 ├─pages.json 配置页面路由、导航条、选项卡等页面类信息,详见 -└─uni.scss 这里是uni-app内置的常用样式变量 +└─uni.scss 这里是uni-app内置的常用样式变量 -**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` 等小程序需要的文件。