Решение для мгновенного обмена сообщениями и видеосвязи «Дикий огонь» (WildfireIM) — это комплексное решение для профессионального обмена мгновенными сообщениями и проведения видеоконференций, поддерживаемое и обслуживаемое компанией Beijing Wildfire Unlimited Network Technology Co., Ltd.

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

Включает следующие проекты:

Демонстрация интеграции возможностей WildfireIM в проект Vue Electron показывает, как можно интегрировать возможности WildfireIM в проекты Vue Electron.

Предварительные замечания

1. Используемый в этом проекте PC SDK является платным, подробности см. в разделе о ценах.
2. PC SDK поддерживает пробное использование, подробнее см. в разделе пробного использования.
3. По умолчанию этот проект может подключаться только к официальному сервису. После покупки или подачи заявки на пробное использование замените PC SDK, чтобы подключиться к самостоятельно развёрнутому сервису.

Ветви

1. master: разработан на основе Vue 3, будущее направление развития.
2. vue2: разработан на основе Vue 2, переходит в режим обслуживания, не разрабатываются новые функции, учитывая, что Vue 2 больше не поддерживается и не обслуживается, рекомендуется клиентам перейти на версию Vue 3.

Зависимости среды

Mac OS

1. Последняя версия Xcode.
2. Node.js версии 18.19.0.
3. NPM версии 10.2.3.
4. Python версии 2.7.X.
5. Git.
6. npm install -g node-gyp@8.3.0.

Windows

1. Node.js версии 18.19.0.
2. Python 2.7.X.
3. Git.
4. NPM 6.14.15.
5. npm install --global --vs2019 --production windows-build-tools. Рекомендуется устанавливать при хорошем интернет-соединении.

   Или обратитесь к разделу ручная установка windows-build-tools для установки.

6. npm install -g node-gyp@8.3.0.

Linux

1. Node.js версии 18.19.0.
2. Python2.7X.
3. Git.
4. Binutils.

Разработка

1. npm config ls для просмотра пути к файлу .npmrc.
2. Добавьте следующую конфигурацию Electron и узла в файл .npmrc:

   ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/
   registry=https://registry.npmmirror.com/
3. npm install или npm ci.
4. npm run dev.

Избегайте использования cnpm, у нас были некоторые странные проблемы с использованием cnpm. Если вы используете cnpm и сталкиваетесь с проблемами, попробуйте переключиться на npm. Кроме того, путь кода не должен содержать китайский язык или пробелы, иначе могут возникнуть проблемы во время разработки и упаковки.

Отладка с помощью vue-devtool

1. npm install -g vue-devtools.
2. Запустите vue-devtools.
3. Следуйте шагу 2. Шаги по добавлению скрипта в public/index.html в head:
4. Вставьте скрипт.

Для запуска проекта выполните следующие действия:

• В каталоге проекта выполните команду: npm run dev.

Упаковка

Упаковка для текущей архитектуры платформы программного обеспечения:

npm run package

Yarn

1. yarn install --ignore-engines
2. yarn run package

GitHub онлайн-упаковка

1. Форкните этот репозиторий.
2. Добавьте, измените функции и т. д.
3. Прочитайте комментарии в файле .github/workflows/github-actions-package.yml и внесите изменения в соответствии с реальной ситуацией, например, упаковывать ли версию Linux и т.д.
4. Перейдите на страницу GitHub forked repository, actions -> упаковка vue-pc-chat -> запустите workflow -> выберите ветку и т.д. -> Run workflow. Более подробную информацию можно найти здесь.

Кросс-упаковка

Упаковка для других архитектур платформ программного обеспечения:

# Упаковка для Windows системы amd64 архитектура
npm run cross-package-win

# Упаковка для Windows системы x86 архитектура
npm run cross-package-win32

# Упаковка для Linux системы amd64 архитектура
npm run cross-package-linux

# Упаковка для Linux системы arm64 архитектура
npm run cross-package-linux-arm64

# Упаковка для Mac системы
npm run cross-package-mac

Версия Electron

В настоящее время используемая версия Electron в master — 13.6.9. Если вы используете SDK версии 8, переключитесь на ветку electron_8. Старая версия перейдёт в стадию обслуживания и больше не будет добавлять новые функции. Разработчики, которые находятся в процессе разработки, могут связаться с нами для обновления до последней версии SDK. SDK не зависит от версии, и если ваше приложение использует другую версию Electron, вы также можете использовать предоставленный нами SDK.

Аудио и видео

По умолчанию поставляется бесплатная версия аудио и видео. Для получения дополнительной информации о Wildfire Audio and Video вы можете обратиться к документации Wildfire Audio and Video и Wildfire Audio and Video Overview. Если используется профессиональная версия аудио и видео, обратитесь к методу переключения профессиональной версии аудио и видео (./src/wfc/av/internal/README.MD).

Общие проблемы разработки

1. Как отлаживать? PC использует Electron, который встраивает Chrome browser, и отладка аналогична разработке в браузере. Сочетание клавиш Ctrl + g (на MAC это CMD + g) открывает режим разработчика.

2. Во время упаковки, если постоянно отображается «установка производственных зависимостей platform=win32 arch=ia32 appDir=C:<your path>\pc-chat\dist», или появляется сообщение о необходимости загрузки чего-либо, можно распаковать соответствующие зависимости electron для конкретной платформы в соответствующие каталоги.

   • Для Windows: C:\Users<ваше имя пользователя>.electron-gyp
   • Для Mac/Linux: ~/.electron-gyp

3. Во время упаковки, если загрузка версии electron занимает слишком много времени, можно использовать китайское зеркало electron. Например, команда для использования зеркала Huawei electron: npm config set electron_mirror https://mirrors.huaweicloud.com/electron/.

4. На Windows необходимо строго следовать инструкциям по установке. На Mac установка node и node-gyp достаточны. Кроме того, если есть другие проблемы, попробуйте выполнить команду npm cache clean --force, затем удалите каталог node_modules и снова установите его без прав администратора npm ci --registry=https://mirrors.huaweicloud.com/repository/npm/.

5. Некоторые антивирусные программы будут сообщать о вирусах в упакованном программном обеспечении electron. Подробную информацию см. в разделе «electron сообщает о вирусе». При установке может быть ограничено антивирусным программным обеспечением, в этом случае пользователи могут использовать неупакованную версию зелёного цвета (в каталоге release неупакованного каталога после упаковки). Если во время выполнения возникает ошибка, разрешите её в антивирусном программном обеспечении. Компании с особыми условиями также могут рассмотреть возможность отправки на проверку в 360 или другие официальные антивирусные компании.

6. На Ubuntu при запуске, если появится сообщение об ошибке: «Произошла ошибка JavaScript в основном процессе Uncaught Exception:Error: Cannot open /opt/wildfirechat/resources/app.asar/marswrapper.node: Error: libdouble-conversion.so.1: невозможно открыть общий объектный файл: Нет такого файла или каталога», можно установить libdouble-conversion1 для решения проблемы.

7. Зависимости приложения wildfire для платформы Windows зависят от Visual C++ Redistributable Package runtime. Если на компьютере пользователя он не установлен, его необходимо установить перед запуском. Вы можете загрузить и установить его с официального сайта Microsoft. Обратите внимание, что установочный пакет различается для 32-битной и 64-битной версий, и необходимо установить соответствующую версию.

8. Приложение для записи экрана на MAC может записывать только пустой рабочий стол, но не содержимое окна. Это связано с тем, что оно не получило разрешение системы безопасности, перейдите в «Настройки» → «Безопасность и конфиденциальность» → «Переключитесь на вкладку конфиденциальности» → «Запись экрана» → установите флажок перед приложением wildfire IM PC и перезапустите приложение.

9. При выполнении команды npm install появляется сообщение «Неожиданный конец ввода JSON при анализе рядом...»

   Если проблема 4 не может быть решена, вы можете попробовать npm config set registry https://mirrors.huaweicloud.com/repository/npm/, а затем выполнить шаги в проблеме 4.

10. Вопросы, связанные с аудио и видео, см. в следующих документах:

    1. av readme (src/wfc/av/internal/README.MD)
    2. Часто задаваемые вопросы об аудио и видео (https://docs.wildfirechat.cn/faq/webrtc.html?h=webrtc)

11. В чисто внутренней сети нельзя отображать смайлики.

    1. Загрузите каталог src/assets/twemoji на внутренний сервер, к которому можно получить доступ, например сервер приложения.
    2. Убедитесь, что вы можете получить доступ к соответствующему смайлику через http(s)://base_twemoji_url/72x72/1f1e6.png, где 1f1e6.png — это синий фон с белым шрифтом A.
    3. Измените config.js, заменив https://static.wildfirechat.net/twemoji/assets/ на новый базовый URL twemoji http(s): //base_twemoji_url/, обратите внимание, что последний / не может быть пропущен.
    4. Динамические смайлики обрабатываются аналогичным образом.

12. Хотите развернуть изображения смайликов самостоятельно?

    См. проблему 11.

13. Постоянно появляется сообщение: «Electron установлен неправильно, удалите node_modules/electron и повторите попытку установки». См. раздел «Использование китайского зеркала Electron».

14. Windows 7 не запускается нормально, показывая чёрный экран или белый экран.

    1. Найдите следующий код в background.js и снимите комментарий перед app.disableHardwareAcceleration();

       // pls refer to: https://blog.csdn.net/youyudexiaowangzi/article/details/118676790
       // windows 7 下面，如果启动黑屏，请将下面注释打开
    

Обратите внимание, что это перевод исходного текста, и некоторые детали могут быть потеряны или интерпретированы по-разному.