Клиент для онлайн-школы «Кугуа» на основе Uni-app

Клиент для онлайн-школы «Кугуа» разработан на основе фреймворка Uni-App, а для создания интерфейса используется библиотека Uview-UI.

Связанные проекты

• Клиент для ПК и API Course-Tencent-Cloud.
• Среда выполнения с использованием Docker Course-Tencent-Cloud-Docker.

Установка и использование

Чтобы избежать лишних проблем, рекомендуется сначала ознакомиться с документацией по Uni-App и HBuilderX.

Скачивание исходного кода

git clone https://gitee.com/koogua/course-tencent-cloud-app.git

Импорт проекта

Импортируйте проект в HBuilderX (Файл → Импорт → Из локальной папки).

1. Создайте файл manifest.json, скопировав файл manifest.sample.json и изменив его в соответствии с вашими потребностями.
2. Создайте файл template.h5.html, скопировав файл template.h5.sample.html и изменив его в соответствии с вашими потребностями.
3. Измените файл config.js в папке common, переименовав файл config.sample.js. В файле измените значение apiBaseUrl на фактический адрес вашего сервера (без добавления косой черты в конце).

export const apiBaseUrl = '{{ your-domain }}/api'

Компиляция и запуск

Скомпилируйте и запустите проект в браузере с помощью HBuilderX (Выполнить → Запустить в браузере → [выбрать браузер]).

Если у вас возникли проблемы с CORS, измените соответствующие настройки в файле config.php проекта course-tencent-cloud. Обратите внимание, что для среды разработки можно использовать подстановочные знаки, а для не-разработки — реальные домены.

/**
 * 允许跨域
 */
$config['cors']['enabled'] = true;

/**
 * 允许跨域域名(字符|数组)
 */
$config['cors']['allow_origin'] = '*';

/**
 * 允许跨域字段（string|array）
 */
$config['cors']['allow_headers'] = '*';

/**
 * 允许跨域方法
 */
$config['cors']['allow_methods'] = ['GET', 'POST', 'OPTIONS'];

Сборка и выпуск

Используйте HBuilderX для сборки и выпуска приложения H5 (Сборка → Веб-сайт PC или мобильное приложение H5).

Выпуск H5

а) Загрузите собранные файлы в локальную папку вашего сервера. Файл manifest.json должен содержать следующие настройки:

"h5" : {
        "title" : "酷瓜云课堂",
        "optimization" : {
            "treeShaking" : {
                "enable" : true
            }
        },
        "router" : {
            "base" : "/h5/",
            "mode" : "hash"
        },
        "sdkConfigs" : {
            "maps" : {}
        },
        "publicPath" : "",
        "template" : "template.h5.html",
        "domain" : "your-domain.com"
    }

б) Загрузите собранные файлы на CDN. Файл index.html должен быть загружен в папку h5 вашего проекта, а файл manifest.json должен содержать следующие настройки:

"h5" : {
        "title" : "酷瓜云课堂",
        "optimization" : {
            "treeShaking" : {
                "enable" : true
            }
        },
        "router" : {
            "base" : "/h5/",
            "mode" : "hash"
        },
        "sdkConfigs" : {
            "maps" : {}
        },
        "publicPath" : "https://course-1255691183.file.myqcloud.com/h5",
        "template" : "template.h5.html",
        "domain" : "your-domain.com"
    }

Если при доступе к странице возникает ошибка 403, измените права доступа к файлу index.html.

chmod 644 public/h5/index.html