1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/Discuz-discuz-fe

Присоединиться к Gitlife
Откройте для себя и примите участие в публичных проектах с открытым исходным кодом с участием более 10 миллионов разработчиков. Приватные репозитории также полностью бесплатны :)
Присоединиться бесплатно
Клонировать/Скачать
user.md 5.4 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
gitlife-traslator Отправлено 30.11.2024 16:45 4f50988

Использование

Рекомендуется использовать команду git clone для загрузки, чтобы упростить последующее обновление.

$ git clone https://gitee.com/Discuz/discuz-fe.git

Установка зависимостей проекта

$ cd discuz-fe
$ cd ./mini
$ npm install

Если вы столкнулись с ошибкой при загрузке зависимостей, можно попробовать сначала запустить следующую команду, изменить источник установки зависимостей.

// Однократное применение
$ npm install --registry=http://mirrors.cloud.tencent.com/npm/
// Постоянное применение
$ npm config set registry http://mirrors.cloud.tencent.com/npm/

Сборка мини-программы

  • Измените appid в файле mini/project.config.json на свой appid (устарело)
  • Измените домен в common/config/prod.js на свой домен (устарело)
  • В каталоге discuz-fe файл dzq.config.yaml является файлом конфигурации среды для Discuz! Q3.0.
    • Измените HOST, чтобы он указывал на ваш домен
    • Измените APPID, чтобы он соответствовал вашему appid
TITLE: Discuz! Q
HOST: 【ваш домен】
APPID: 【ваш appid】
VERSION: v3.0.210729
  • Соберите мини-программу
$ cd ./mini
$ npm install
$ npm run build:weapp

Как обновить

Использование git для загрузки кода

Введите команду в командной строке, перейдите в каталог этого репозитория и выполните следующие команды:

// Обновить код репозитория
$ git pull origin master

// Обновить основные зависимости dzq3.0
$ npm run update

// Обновить другие зависимости
$ npm install

// Пересобрать
$ npm run build:weapp

Обратите внимание!!!

Если вы изменили домен и appid вашей мини-программы, то при каждом обновлении кода через git могут возникать конфликты, которые не позволят успешно обновить код. Обычно возникают конфликты в следующих файлах:

  • ./mini/common/config/prod.js(устарело)
  • ./mini/project.config.json(устарело)
  • ./discuz-fe/dzq.config.yaml
  • ./mini/project.config.json

Вы можете сохранить изменённый код с помощью следующей команды, а затем восстановить его после обновления.

$ git add .
$ git stash

// Выполнить обновление кода
$ git pull origin master

// Восстановить ваши изменения
$ git stash pop

// Обновить ядро dzq3.0
$ npm run update

// Обновить остальные зависимости
$ npm install

// Пересобрать
$ npm run build:weapp

Загрузка кода с помощью zip

Если вы загружаете код с помощью zip, выполните следующие команды:

// Обновить остальные зависимости
$ npm install

// Пересобрать
$ npm run build:weapp

Публикация

Исходный код собранной мини-программы находится в папке mini/dist. Вы можете открыть его с помощью инструмента разработчика WeChat и отправить на проверку.

Распространённые проблемы

Если у вас возникнут следующие проблемы:

npm ERR! code ERESOLVE
npm ERR! ERESOLVE unable to resolve dependency tree
npm ERR! 
npm ERR! While resolving: discuz-app-mini@0.0.1-beta.3
npm ERR! Found: react@17.0.1
npm ERR! node_modules/react
npm ERR!   react@"17.0.1" from the root project
npm ERR! 
npm ERR! Could not resolve dependency:
npm ERR! peer react@"^16.8.0 || 16.9.0-alpha.0" from mobx-react@6.1.4
npm ERR! node_modules/mobx-react
npm ERR!   mobx-react@"6.1.4" from the root project
npm ERR! 
npm ERR! Fix the upstream dependency conflict, or retry
npm ERR! this command with --force, or --legacy-peer-deps
npm ERR! to accept an incorrect (and potentially broken) dependency resolution.
npm ERR! 
npm ERR! See /Users/xxx/.npm/eresolve-report.txt for a full report.

npm ERR! A complete log of this run can be found in:
npm ERR!     /Users/xxx/.npm/_logs/2021-07-02T17_24_15_418Z-debug.log

Это связано с тем, что версия node слишком высока (выше 14), рекомендуется временно использовать версию node 14 для компиляции.

Если вы используете Mac с чипом M1, сначала установите NVM, а затем используйте NVM для установки версии ARM node 14.

$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.38.0/install.sh | bash
$ nvm install v14
$ node -v
1
https://api.gitlife.ru/oschina-mirror/Discuz-discuz-fe.git
git@api.gitlife.ru:oschina-mirror/Discuz-discuz-fe.git
oschina-mirror
Discuz-discuz-fe
Discuz-discuz-fe
master