# NPM安装方式配置

# 关于SCSS

uView依赖SCSS，您必须要安装此插件，否则无法正常运行。

• 如果您的项目是由HBuilder X创建的，相信已经安装scss插件，如果没有，请在HX菜单的 工具->插件安装中找到"scss/sass编译"插件进行安装， 如不生效，重启HX即可
• 如果您的项目是由vue-cli创建的，请通过以下命令安装对sass(scss)的支持，如果已安装，请略过。

// 安装sass
npm i sass -D

// 安装sass-loader，注意需要版本10，否则可能会导致vue与sass的兼容问题而报错
npm i sass-loader@10 -D
✅ Copy success!
copy

# 准备工作

在进行配置之前，请确保您已经根据安装中的步骤对uView进行了npm安装，如果没有，请先执行安装：

// 如果您的项目是HX创建的，根目录又没有package.json文件的话，请先执行如下命令：
// npm init -y

// 安装
npm install uview-next
✅ Copy success!
copy

# 配置步骤 (4步)

main.js uni.scss App.vue pages.json4个文件中都要进行配置

# 1. 引入uView Next主JS库，注意vue2和vue3的用法不同

在项目根目录中的main.js中，引入并使用uView的JS库，注意这两行要放在import Vue之后。

import App from './App';
import uViewNext from 'uview-next';

//你的其他代码

Vue.config.productionTip = false

//加入这一句
Vue.use(uViewNext);

App.mpType = 'app'
const app = new Vue({
  ...App
})
app.$mount()
✅ Copy success!
copy

import App from './App';
import uViewNext from 'uview-next';

//你的其他代码

import { createSSRApp } from 'vue';
export function createApp() {
	const app = createSSRApp(App);

	//加入这一句
	app.use(uViewNext);
	
	return {
		app
	};
}
✅ Copy success!
copy

# 2. 在引入uView Next的全局SCSS主题文件

在项目根目录的 uni.scss 中第一行的位置引入此文件。

@import 'uview-next/theme.scss';
✅ Copy success!
copy

# 3. 引入uView基础样式

在App.vue中第一行的位置引入，注意给style标签加入lang="scss"属性

<style lang="scss">
	@import "uview-next/index.scss";
</style>
✅ Copy success!
copy

# 4. 配置easycom组件模式

此配置需要在项目根目录的pages.json中进行。

{
	"easycom": {
		"custom": {
			"^u-(.*)": "uview-next/components/u-$1/u-$1.vue"
		}
	},
	// 此为本身已有的内容
	"pages": [
		// ......
	]
}
✅ Copy success!
copy