获取源码、构建和发布

PC 端

概述

PC端源码包，可用于开发者进行二次开发，PC 二次开发依赖 node 环境，请提前部署好 node 环境，以下为 PC 端源码包下载及使用进行说明。

前提条件

  • 在使用 Discuz! Q 小程序之前，请先安装好您的 Discuz! Q。
  • 已下载 PC 端源码包至本地并解压缩到一个目录中。下载最新PC端代码 (opens new window)。

操作指南

步骤一：开发配置

  1. 修改项目中api/request.js 中第9行、nuxt.config.js 第10行、package.json 中xxx.com 替换为自己服务域名。

开发过程代理配置静态nginx 配置。如下所示：

  1. server {
  2.         listen 80 default_server;
  3.         listen [::]:80 default_server;
  4.         server_name _;
  5.         root /usr/share/nginx/dist;
  6.         index index.html;
  8.         location /api/ {
  9.          proxy_pass https://xxx.com;
  10.          client_max_body_size 200M;
  11.         }
  12. }

步骤二：开发

基于 PC 端源码包进行二次开发。

步骤三：开发完成打包前配置

开发完成后不同版本的打包后目录不同。请根据实际需求进行选择：

v2.3.210202 版本
  1. 修改根目录下面的config.js 文件，DEV_API_URL，SSR_API_URL两个字段值替换为自己的服务域名，并在项目目录下运行方式一下的命令，当方式一命令运行失败时推荐采用方式二的命令：

方式一：

  1. npm install

方式二：

  1. npm install -g yarn
  2. yarn config set registry https://registry.npm.taobao.org
  3. yarn config set sass_binary_site https://npm.taobao.org/mirrors/node-sass/
  4. yarn install

不包含ssr 的静态化蓝版部署请使用命令：npm run build:spa。

  1. 生成dist 目录，将以下生成的文件上传至 Discuz! Q 服务器上的piblic 和public_1 目录下:
  1. dist
  2.    index.html 修改为 pc.html 复制到discuz项目public、public_1目录下
  3.    200.html 复制到discuz项目public、public_1目录下
  4.    _nuxt 复制到discuz项目public、public_1目录下
  5.    invite 复制到discuz项目public、public_1目录下
  6.    manage 复制到discuz项目public、public_1目录下
  7.    modify 复制到discuz项目public、public_1目录下
  8.    my 复制到discuz项目public、public_1目录下
  9.    site 复制到discuz项目public、public_1目录下
  10.    thread 复制到discuz项目public、public_1目录下
  11.    topic 复制到discuz项目public、public_1目录下
  12.    user 复制到discuz项目public、public_1目录下

以上执行若有同名则选择覆盖原文件，如果没有public_1 目录则在与public 同级的目录下新建一个。

不包含ssr 的静态化红版部署请使用命令：npm run build:pay-spa。

  1. 生成dist 目录，将以下生成的文件上传至 Discuz! Q 服务器上的public_2 目录下:
  1. dist
  2.    index.html 修改为 pc.html 复制到discuz项目public_2目录下
  3.    200.html 复制到discuz项目public_2目录下
  4.    _nuxt 复制到discuz项目public_2目录下
  5.    invite 复制到discuz项目public_2目录下
  6.    manage 复制到discuz项目public_2目录下
  7.    modify 复制到discuz项目public_2目录下
  8.    my 复制到discuz项目public_2目录下
  9.    site 复制到discuz项目public_2目录下
  10.    thread 复制到discuz项目public_2目录下
  11.    topic 复制到discuz项目public_2目录下
  12.    user 复制到discuz项目public_2目录下

以上执行若有同名则选择覆盖原文件，如果没有public_2 目录则在与public 同级的目录下新建一个。

v2.1.201117 版本
  1. 修改根目录下面的config.js 文件，DEV_API_URL，SSR_API_URL两个字段值替换为自己的服务域名,并在项目目录下运行以下命令：
  1. npm install

不包含ssr 的静态化部署请使用命令：npm run build:spa。

  1. 生成dist 目录，将以下生成的文件上传至 Discuz! Q 服务器上:
  1. dist
  2.    index.html 修改为 pc.html 复制到discuz项目public目录下
  3.    200.html 复制到discuz项目public目录下
  4.    _nuxt 复制到discuz项目public目录下
  5.    invite 复制到discuz项目public目录下
  6.    manage 复制到discuz项目public目录下
  7.    modify 复制到discuz项目public目录下
  8.    my 复制到discuz项目public目录下
  9.    site 复制到discuz项目public目录下
  10.    thread 复制到discuz项目public目录下
  11.    topic 复制到discuz项目public目录下
  12.    user 复制到discuz项目public目录下

以上执行若有同名则选择覆盖原文件。

v2.1.201113 版本
  1. 修改根目录下面的package.json 文件，把打包命令build 和start 里面的VUE_APP_CONFIG_API_URL修改成自己服务的域名地址。如接口地址是https://xxx.com:
  1.  "build": "VUE_APP_CONFIG_API_URL=https://xxx.com nuxt build",
  2.   "start": "VUE_APP_CONFIG_API_URL=https://xxx.com nuxt start",
  1. 在项目目录下运行以下命令安装依赖：
  1. npm install

不包含ssr 的静态化部署请使用命令：npm run generate。

3.生成dist 目录，将以下生成的文件上传至 Discuz! Q 服务器上:

  1. dist
  2.    index.html 修改为 pc.html 复制到discuz项目public目录下
  3.    200.html 复制到discuz项目public目录下
  4.    _nuxt 复制到discuz项目public目录下
  5.    pages 修改为pc-pages 复制到discuz项目public目录下
  6.    topic 修改为pc-topic 复制到discuz项目public目录下

以上执行若有同名则选择覆盖原文件。

H5与小程序端

概述

Discuz! Q 的小程序与 H5 前端，基于 uni-app 开发框架，现支持发行为微信小程序和H5。 前提条件

操作指南

步骤一：开发环境配置

您可以根据以下两种方式安装部署 H5 与小程序端的构建环境。

步骤二：开发

基于小程序与H5前端源码 (opens new window)进行二次开发。

步骤三：调试

TIP

本地调试小程序或H5，目前只支持 npm 方式构建。

在开发过程中您可以对您的二次源码进行本地调试，具体可参考：小程序调试。

步骤三：发布

开发完成后，您可以将您的源码发布在微信小程序小程序。具体可参考：微信小程序发布

发布前请确保已按照微信小程序基本配置说明已配置服务器域名，否则将导致小程序无法与 Discuz! Q 进行数据通讯。