UniApp 开发微信小程序教程(一):准备工作和环境搭建,项目结构和配置

文章目录

    • 一、准备工作和环境搭建
      • [1. 安装 HBuilderX](#1. 安装 HBuilderX)
      • [2. 注册微信开发者账号](#2. 注册微信开发者账号)
      • [3. 创建 UniApp 项目](#3. 创建 UniApp 项目)
    • 二、项目结构和配置
      • [1. UniApp 项目结构](#1. UniApp 项目结构)
      • [2. 配置微信小程序](#2. 配置微信小程序)
        • [修改 `manifest.json`](#修改 manifest.json)
        • [修改 `pages.json`](#修改 pages.json)
      • [3. 添加首页文件](#3. 添加首页文件)
        • [`index.vue` 示例:](#index.vue 示例:)
        • [4. 图示](#4. 图示)
    • 三、总结

🎉欢迎来到 Uniapp 开发微信小程序教程专栏~准备工作和环境搭建,项目结构和配置



欢迎来到《UniApp 微信小程序开发指南》的第一篇文章。在这篇文章中,我们将带领你完成 UniApp 开发环境的搭建,并介绍项目的基本结构和配置。无论你是新手还是有一定开发经验,这篇文章都将帮助你顺利开始 UniApp 开发之旅。

一、准备工作和环境搭建

1. 安装 HBuilderX

HBuilderX 是由 DCloud 推出的用于开发 UniApp 的强大 IDE。它支持 Vue.js,提供了许多实用的功能,极大地提升开发效率。

步骤:
  1. 下载 HBuilderX
    前往 HBuilderX 下载页面 下载适合你操作系统的安装包。
  1. 安装 HBuilderX
    根据你的操作系统,运行下载的安装包,并按照提示完成安装。

2. 注册微信开发者账号

在开发微信小程序之前,你需要一个微信开发者账号。

步骤:
  1. 访问微信公众平台
    前往 微信公众平台,点击右上角的"立即注册"。
  1. 选择账号类型
    选择"小程序",并按照提示完成注册流程。
  1. 获取 AppID
    注册完成后,在"开发设置"页面,你可以找到你的小程序 AppID。这个 AppID 将在项目配置中使用。

3. 创建 UniApp 项目

使用 HBuilderX 创建一个新的 UniApp 项目,这是我们开发小程序的起点。

步骤:
  1. 打开 HBuilderX
    运行 HBuilderX,点击"文件" -> "新建" -> "项目"。
  1. 选择项目模板
    在弹出的对话框中,选择"uni-app"项目模板。
  1. 填写项目信息
    输入项目名称、保存路径等信息,确保"创建为标准uni-app项目"被选中,然后点击"创建"。

二、项目结构和配置

1. UniApp 项目结构

一个标准的 UniApp 项目包含以下主要目录和文件:

复制代码
|-- 项目根目录
    |-- components          // 存放自定义组件
    |-- pages               // 存放各个页面
        |-- index
            |-- index.vue   // 首页文件
    |-- static              // 存放静态资源,如图片、样式等
    |-- unpackage           // 打包输出目录
    |-- App.vue             // 应用入口文件
    |-- main.js             // 应用入口文件
    |-- manifest.json       // 配置文件
    |-- pages.json          // 页面配置文件
    |-- uni.scss            // 通用样式文件

2. 配置微信小程序

修改 manifest.json

manifest.json 文件包含了应用的全局配置,包括应用名称、版本、图标等。对于微信小程序,我们需要在其中添加 AppID 和其他相关配置。

json 复制代码
{
    "name": "your-app-name",
    "appid": "__UNI__XXXXXXX",
    "versionName": "1.0.0",
    "versionCode": "100",
    "uni-app": {
        "nvueCompiler": "weex",
        "renderer": "auto",
        "usingComponents": true
    },
    "mp-weixin": {
        "appid": "your-wechat-appid",  // 替换为你的微信小程序 AppID
        "setting": {
            "urlCheck": false
        }
    }
}
修改 pages.json

pages.json 文件用于配置页面路径、窗口风格、底部导航等。一个简单的配置示例如下:

json 复制代码
{
    "pages": [
        {
            "path": "pages/index/index",
            "style": {
                "navigationBarTitleText": "首页"
            }
        }
    ],
    "globalStyle": {
        "navigationBarTextStyle": "black",
        "navigationBarTitleText": "UniApp",
        "navigationBarBackgroundColor": "#F8F8F8",
        "backgroundColor": "#F8F8F8"
    }
}

3. 添加首页文件

pages/index 目录下,我们已经有了一个 index.vue 文件。你可以在这个文件中添加你的首页内容。

index.vue 示例:
html 复制代码
<template>
  <view class="content">
    <text class="title">欢迎来到 UniApp 微信小程序开发!</text>
  </view>
</template>

<script>
export default {
  data() {
    return {
      message: 'Hello UniApp'
    }
  }
}
</script>

<style scoped>
.content {
  display: flex;
  align-items: center;
  justify-content: center;
  height: 100vh;
  background-color: #fff;
}
.title {
  font-size: 20px;
  color: #333;
}
</style>
4. 图示

运行到浏览器,就可以看到当前首页的效果啦

就是这个样子:(下一期带大家安装微信开发者工具,小程序开发更便捷)

三、总结

通过本篇文章,你已经完成了 UniApp 开发环境的搭建,了解了项目的基本结构,并进行了初步的配置。在接下来的文章中,我们将深入探索页面设计、数据管理和接口调用等关键技术,帮助你一步步掌握 UniApp 微信小程序开发的核心技能。

如果你有任何问题或建议,欢迎在评论区留言。让我们一起进入 UniApp 开发的精彩世界!


🧸结尾 ❤️ 感谢您的支持和鼓励! 😊🙏

📜您可能感兴趣的内容:

相关推荐
wordbaby14 小时前
从双端内卷到一库多端:基于 pnpm + Taro 4 + RNOH 鸿蒙的 Monorepo 跨端架构实战
前端·微信小程序·app
PedroQue9917 小时前
Vue Router 4.x风格导航守卫全面升级
前端·uni-app
Haibakeji20 小时前
APP小程序定制开发项目频繁延期?前期规避方法与落地避坑指南
小程序·uni-app·软件需求
anyup21 小时前
迁移uni-app x,我是如何让 AI 把我一步步搞崩溃的...
前端·uni-app·trae
2501_916007471 天前
申请 iOS 推送证书并配置 APNs 群发推送教程
android·ios·小程序·https·uni-app·iphone·webview
博客zhu虎康1 天前
uni-app云打包显示编译成功,但是一直没有进入打包队列,后面也一直没反应
uni-app
JavaDog程序狗2 天前
【指南】uni-app微信小程序多环境CI-CD完全指南
ci/cd·uni-app·jenkins
PedroQue992 天前
uni-router v2.1.0 升级:导航守卫全面支持返回值模式
前端·uni-app
码云之上2 天前
小程序 iOS 多输入框焦点乱序脱坑记
ios·微信小程序·taro
2501_915909063 天前
iOS test 测试怎么做?功能、性能、兼容、稳定与安全五类测试指南
android·ios·小程序·https·uni-app·iphone·webview