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** 可快速生成条件编译的代码片段
-
+

**语法高亮**
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` 等小程序需要的文件。