From 80d2dda6ae767cb8b45c665f87c6ac444630abe3 Mon Sep 17 00:00:00 2001
From: liuxiaohang <283700113@qq.com>
Date: Fri, 10 Jun 2022 20:28:04 +0800
Subject: [PATCH] chore: vite-config.md

---
 docs/collocation/_sidebar.md    |   1 +
 docs/collocation/vite-config.md | 177 ++++++++++++++++++++++++++++++++
 docs/collocation/vue-config.md  |   1 +
 3 files changed, 179 insertions(+)
 create mode 100644 docs/collocation/vite-config.md

diff --git a/docs/collocation/_sidebar.md b/docs/collocation/_sidebar.md
index 98f054945..2e75cf672 100644
--- a/docs/collocation/_sidebar.md
+++ b/docs/collocation/_sidebar.md
@@ -2,6 +2,7 @@
 * [manifest.json 应用配置](collocation/manifest.md)
 * [package.json](collocation/package.md)
 * [vue.config.js](collocation/vue-config.md)
+* [vite.config.js](collocation/vite-config.md)
 * [uni.scss](collocation/uni-scss.md)
 * [App.vue](collocation/App.md)
 * [main.js](collocation/main.md)
diff --git a/docs/collocation/vite-config.md b/docs/collocation/vite-config.md
new file mode 100644
index 000000000..ab05ad62b
--- /dev/null
+++ b/docs/collocation/vite-config.md
@@ -0,0 +1,177 @@
+vite.config.js 是一个可选的配置文件，如果项目的根目录中存在这个文件，那么它会被自动加载，一般用于配置 vite 的编译选项，具体规范参考：[vite.config.js](https://cn.vitejs.dev/)
+
+**支持情况**
+
+- CLI 工程 [创建教程](/quickstart-cli)
+- HBuilderX 3.2.0 及以上版本
+
+**注意事项**
+
+- 仅`vue 3`项目生效
+
+部分配置项会被编译配置覆盖，例如：
+
+- base：支持
+- root：不支持
+- mode：不支持
+- publicDir: 不支持，固定为 static
+- build.outDir：不支持
+- build.assetsInlineLimit：仅 h5 支持
+- build.cssCodeSplit：不支持，固定为 true
+- build.lib：不支持
+- build.manifest：不支持
+- build.ssrManifest：不支持
+- build.ssr：不支持
+
+**基础内容**
+
+> 必须引用 '@dcloudio/vite-plugin-uni' 并且添加到 plugins 中
+
+```js
+import { defineConfig } from 'vite';
+import uni from '@dcloudio/vite-plugin-uni';
+
+export default defineConfig({
+	plugins: [uni()],
+});
+```
+
+**使用示例**
+
+**自定义静态资源目录**
+
+```js
+import path from 'path';
+import fs from 'fs-extra';
+import { defineConfig } from 'vite';
+import uni from '@dcloudio/vite-plugin-uni';
+
+function copyFile() {
+	return {
+		enforce: 'post',
+		async writeBundle() {
+			await fs.copy(
+				path.resolve(__dirname, 'images'),
+				path.join(
+					__dirname,
+					'unpackage/dist',
+					process.env.NODE_ENV === 'production' ? 'build' : 'dev',
+					process.env.UNI_PLATFORM,
+					'images'
+				)
+			);
+		},
+	};
+}
+
+export default defineConfig({
+	plugins: [uni(), copyFile()],
+});
+```
+
+**注入全局依赖**
+
+```js
+// 示例从插件市场下载 mp-storage
+import path from 'path';
+import { defineConfig } from 'vite';
+import uni from '@dcloudio/vite-plugin-uni';
+import inject from '@rollup/plugin-inject';
+
+const mpStoragePath = path.resolve(__dirname, './js_sdk/mp-storage/mp-storage');
+
+export default defineConfig({
+	plugins: [
+		uni(),
+		inject({
+			localStorage: [mpStoragePath, 'localStorage'],
+			'window.localStorage': [mpStoragePath, 'localStorage'],
+		}),
+	],
+	define: {
+		'process.env.VUE_APP_TEST': JSON.stringify('test'),
+	},
+});
+```
+
+**配置环境变量**
+
+```js
+import { defineConfig } from 'vite';
+import uni from '@dcloudio/vite-plugin-uni';
+
+export default defineConfig({
+	plugins: [uni()],
+	define: {
+		'process.env.VUE_APP_TEST': JSON.stringify('test'),
+	},
+});
+```
+
+**发布时删除 console**
+
+```js
+import { defineConfig } from 'vite';
+import uni from '@dcloudio/vite-plugin-uni';
+
+export default defineConfig({
+	plugins: [uni()],
+	build: {
+		minify: 'terser',
+		terserOptions: {
+			compress: {
+				drop_console: true,
+			},
+		},
+	},
+});
+```
+
+**发布时动态修改 manifest.json**
+
+```js
+// 读取 manifest.json ，修改后重新写入
+const fs = require('fs');
+
+const manifestPath = './src/manifest.json';
+let Manifest = fs.readFileSync(manifestPath, { encoding: 'utf-8' });
+function replaceManifest(path, value) {
+	const arr = path.split('.');
+	const len = arr.length;
+	const lastItem = arr[len - 1];
+
+	let i = 0;
+	let ManifestArr = Manifest.split(/\n/);
+
+	for (let index = 0; index < ManifestArr.length; index++) {
+		const item = ManifestArr[index];
+		if (new RegExp(`"${arr[i]}"`).test(item)) ++i;
+		if (i === len) {
+			const hasComma = /,/.test(item);
+			ManifestArr[index] = item.replace(
+				new RegExp(`"${lastItem}"[\\s\\S]*:[\\s\\S]*`),
+				`"${lastItem}": ${value}${hasComma ? ',' : ''}`
+			);
+			break;
+		}
+	}
+
+	Manifest = ManifestArr.join('\n');
+}
+// 使用
+replaceManifest('app-plus.usingComponents', false);
+replaceManifest('app-plus.splashscreen.alwaysShowBeforeRender', false);
+replaceManifest('mp-baidu.usingComponents', false);
+fs.writeFileSync(manifestPath, Manifest, {
+	flag: 'w',
+});
+
+export default defineConfig({
+	// ...
+});
+```
+
+启用压缩的方法：
+
+- HBuilderX 创建的项目勾选运行-->运行到小程序模拟器-->运行时是否压缩代码
+- cli 创建的项目可以在`package.json`中添加参数`--minify`
diff --git a/docs/collocation/vue-config.md b/docs/collocation/vue-config.md
index 944c913ca..828442bb2 100644
--- a/docs/collocation/vue-config.md
+++ b/docs/collocation/vue-config.md
@@ -45,6 +45,7 @@ module.exports = {
 **注入全局依赖**
 
 ```js
+// 示例从插件市场下载 mp-storage
 const webpack = require('webpack')
 
 module.exports = {
-- 
GitLab