(一)、项目介绍及知识点概述【uniapp+uinicloud多用户社区博客实战项目(完整开发文档-从零到完整项目)】

谁践踏了优雅 2024-03-27 16:45 8阅读 0赞

### 1，完整项目展示 ###

![在这里插入图片描述][89a5da021e4d4a2babd36d1758a52df2.png]

### 2，项目涉及知识点 ###

需要注册认证dcloud账号，官网链接：[dlcoud开发者中心][dlcoud]

#### 2.1 使用uniapp官方的前端界面插件uni-ui ####

uni-ui可以从dloud插件市场免费下载或者使用hbuilder直接导入使用  
![在这里插入图片描述][624301aab6894154aa420ae38de2cf8f.png]

![8df40011ebf44a14b30f554f5736d57e.png][]

[uni-ui网站链接][uni-ui]

uni-ui支持 HBuilderX直接新建项目模板、npm安装和单独导入个别组件等多种使用方式

在HBuilderX 新建uni-app项目的模板中，选择uni-ui模板  
HBuilderX内创建uni-ui项目  
![在这里插入图片描述][82fce19871624b40a886159d5b274e45.png]

由于uni-app独特的easycom技术，可以免引用、注册，直接使用各种符合规则的vue组件。

在代码区键入u，拉出各种内置或uni-ui的组件列表，选择其中一个，即可使用该组件。

光标放在组件名称上，按F1，可以查阅组件的文档。  
![在这里插入图片描述][5a5cf4246a9349f889e5b89c0b9dde8c.png]  
通过 uni\_modules 单独安装组件  
如果你没有创建uni-ui项目模板，也可以在你的工程里，通过 uni\_modules 单独安装需要的某个组件。下表为uni-ui的扩展组件清单，点击每个组件在详情页面可以导入组件到项目下，导入后直接使用即可，无需import和注册。

使用 uni\_modules 方式安装组件库，可以直接通过插件市场导入，通过右键菜单快速更新组件，不需要引用、注册，直接在页面中使用 uni-ui 组件。点击安装 uni-ui 组件库

注意：下载最新的组件目前仅支持 uni\_modules ,非 uni\_modules 版本最高支持到组件的1.2.10版本

如不能升级到 uni\_modules 版本，可以使用 uni\_modules 安装好对应组件，将组件拷贝到对应目录。

例如需更新 uni-list和uni-badge ,将 uni\_modules>uni-list>components和uni\_modules>uni-badege>components下所有目录拷贝到如下目录即可：

目录示例

┌─components              组件目录
    │  ├─uni-list             list 列表目录
    │  │  └─uni-list.vue      list 组件文件
    │  ├─uni-list-item        list-item 列表目录
    │  │  └─uni-list-item.vue list 组件文件
    │  ├─uni-badge            badge 角标目录
    │  │  └─uni-badge.vue     badge 组件文件
    │  └─ //....              更多组件文件
    ├─pages                   业务页面文件存放的目录
    │  ├─index
    │  │  └─index.vue         index示例页面
    ├─main.js                 Vue初始化入口文件
    ├─App.vue                 应用配置，用来配置App全局样式以及监听 应用生命周期
    ├─manifest.json           配置应用名称、appid、logo、版本等打包信息，详见
    └─pages.json              配置页

通过 uni\_modules 导入全部组件  
如果想一次把所有uni-ui组件导入到项目中，只需要导入一个 uni-ui 组件即可 点击去导入。

如果没有自动导入其他组件，可以在 uni-ui 组件目录上右键选择 安装三方插件依赖 即可。

npm安装  
在 vue-cli 项目中可以使用 npm 安装 uni-ui 库 ，或者直接在 HBuilderX 项目中使用 npm 。

注意 cli 项目默认是不编译 node\_modules 下的组件的，导致条件编译等功能失效 ，导致组件异常 需要在根目录创建 vue.config.js 文件 ，增加 @dcloudio/uni-ui 包的编译即可正常

// vue.config.js
    module.exports = {
        
          transpileDependencies:['@dcloudio/uni-ui']
    }

准备 sass

vue-cli 项目请先安装 sass 及 sass-loader，如在 HBuliderX 中使用，可跳过此步。

安装 sass

npm i sass -D 或 yarn add sass -D  
安装 sass-loader

npm i sass-loader@10.1.1 -D   或   yarn add sass-loader@10.1.1 -D

如果 node 版本小于 16 ，sass-loader 请使用低于 @11.0.0 的版本，sass-loader@11.0.0 不支持 vue@2.6.12 如果 node 版本大于 16 ， sass-loader 建议使用 v8.x 版本

安装 uni-ui

npm i @dcloudio/uni-ui   或   yarn add @dcloudio/uni-ui

配置easycom

使用 npm 安装好 uni-ui 之后，需要配置 easycom 规则，让 npm 安装的组件支持 easycom

打开项目根目录下的 pages.json 并添加 easycom 节点：

// pages.json
    {
        
        "easycom": {
        
            "autoscan": true,
            "custom": {
        
                // uni-ui 规则如下配置
                "^uni-(.*)": "@dcloudio/uni-ui/lib/uni-$1/uni-$1.vue"
            }
        },
    
        // 其他内容
        pages:[
            // ...
        ]
    }

在 template 中使用组件：

<uni-badge text="1"></uni-badge>
    <uni-badge text="2" type="success" @click="bindClick"></uni-badge>
    <uni-badge text="3" type="primary" :inverted="true"></uni-badge>

注意

uni-ui 现在只推荐使用 easycom ，如自己引用组件，可能会出现组件找不到的问题  
使用 npm 安装的组件，默认情况下 babel-loader 会忽略所有 node\_modules 中的文件 ，导致条件编译失效，需要通过配置 vue.config.js 解决：

// 在根目录创建 vue.config.js 文件，并配置如下
     module.exports = {
        
        transpileDependencies: ['@dcloudio/uni-ui']
     }

uni-ui 是uni-app内置组件的扩展。注意与web开发不同，uni-ui不包括基础组件，它是基础组件的补充。web开发中有的开发者习惯用一个ui库完成所有开发，但在uni-app体系中，推荐开发者首先使用性能更高的基础组件，然后按需引入必要的扩展组件。  
uni-ui 不支持使用 Vue.use() 的方式安装。

#### 2.2 使用uview框架 ####

[uview官网链接][uview]  
uView是uni-app生态专用的UI框架，uni-app 是一个使用 Vue.js 开发所有前端应用的框架，开发者编写一套代码， 可发布到iOS、Android、H5、以及各种小程序(微信/支付宝/百度/头条/QQ/钉钉)等多个平台(引言自uni-app网)。但目前除微信小程序，其它小程序平台的兼容可能存在一些问题，后续会针对这方面持续优化。

#### 2.3 使用iconfont图标 ####

[阿里巴巴图标库][Link 1]  
需要注册后登录使用。

#### 2.4 node.js安装及环境配置超详细教程【Windows系统安装包方式】 ####

请参照：[node.js安装及环境配置超详细教程][node.js]

***注意：新版的NodeJS已经集成了npm，所以npm也一并安装好了。  
可以在cmd命令行输入" npm -v"来测试是否成功安装。如出现版本提示便OK了***。

[89a5da021e4d4a2babd36d1758a52df2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/aa287848da904017b4807f405ffa6d59.png
[dlcoud]: https://dev.dcloud.net.cn/
[624301aab6894154aa420ae38de2cf8f.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/4eb9971aca8e4ade80863c878d23b9c3.png
[8df40011ebf44a14b30f554f5736d57e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/5031461488634dac90e43320652a5d41.png
[uni-ui]: https://ext.dcloud.net.cn/plugin?id=55
[82fce19871624b40a886159d5b274e45.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/ed97d83d9acd4259a3589134f207c1af.png
[5a5cf4246a9349f889e5b89c0b9dde8c.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/27/569016f493824420a6646f3d6702ea2f.png
[uview]: https://www.uviewui.com/
[Link 1]: https://www.iconfont.cn/
[node.js]: https://blog.csdn.net/weixin_44893902/article/details/121788104?ops_request_misc=%257B%2522request%255Fid%2522%253A%2522167630500516800180657878%2522%252C%2522scm%2522%253A%252220140713.130102334..%2522%257D&request_id=167630500516800180657878&biz_id=0&utm_medium=distribute.pc_search_result.none-task-blog-2~all~top_positive~default-1-121788104-null-null.142%5Ev73%5Einsert_down4,201%5Ev4%5Eadd_ask,239%5Ev1%5Einsert_chatgpt&utm_term=nodejs%E5%AE%89%E8%A3%85%E5%8F%8A%E7%8E%AF%E5%A2%83%E9%85%8D%E7%BD%AE&spm=1018.2226.3001.4187