Android платформа 5+ App/uni-app: запуск среды с открытым исходным кодом

Важно: используйте HBuilderX 2.3.7-20191024 для создания локальных упакованных ресурсов приложения, иначе проект uni-app может выдать сообщение об ошибке «Версия среды выполнения и версия компилятора не совпадают», подробности см. в https://ask.dcloud.net.cn/article/35627.

Описание

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

Если разработчик хочет изменить исходный код проекта, обратите внимание на разделение между «движком» и «плагином». «Движок» — это реализация спецификации 5+/uni-app, изменение исходного кода движка может оптимизировать реализацию спецификации, но не предоставляет функции, выходящие за рамки спецификации. Функции, выходящие за рамки спецификаций, должны быть реализованы как «плагины». Если они должны быть общедоступными, их следует разместить на рынке плагинов. Например, если существующая спецификация сканирования QR-кода уже существует в 5+/uni-app, но разработчик недоволен эффективностью сканирования, он может улучшить реализацию и повторно собрать движок. Однако, если разработчик хочет добавить функцию дополненной реальности (AR), её следует реализовать как плагин, а не добавлять в проект. То есть разработчик не может самостоятельно добавлять новые API-интерфейсы JavaScript в спецификацию 5+/uni-app.

Понимание всего исходного кода любого проекта — непростая задача. Обычно разработчики имеют потребности в изменениях, которые сосредоточены на некоторых возможностях или реализации SDK. Например, сканирование QR-кодов, видео, карты, прямые трансляции, камеры, фотоальбомы, Bluetooth и т. д., а также некоторые текстовые элементы интерфейса. Сосредоточившись только на определённых функциях, разработчикам будет легче понять и внести изменения.

Из-за ограниченных ресурсов некоторые модули, такие как исходный код weex, настроенный DCloud, ещё не полностью упорядочен и временно предоставляется в виде библиотеки. В будущем будет предоставлен полный исходный код. Однако это не влияет на способность разработчиков изменять другие исходные коды и компилировать проект.

Соответствие между модулями и исходными кодами

Видеоплеер (видеопроигрыватель)

VideoPlayer(视频播放) | feature/media | plus.video.VideoPlayer | https://uniapp.dcloud.io/api/media/video |

XHR (сетевой запрос)

XHR(网络请求) | feature/xhr | plus.net | https://uniapp.dcloud.io/api/request/request?id=request |

Нативные компоненты Nvue: карта (карта Baidu)

nvue原生组件: map(高德地图) | feature/weex_amap | не поддерживается | https://uniapp.dcloud.io/component/map |

Нативные компоненты Nvue: штрихкод (двумерный код)

nvue原生组件: barcode(二维码) | feature/weex_barcode | не поддерживается | https://uniapp.dcloud.io/component/barcode |

Нативные компоненты Nvue: live-pusher (прямая трансляция)

nvue原生组件: live-pusher(直播推流) | feature/weex_livepusher | не поддерживается | https://uniapp.dcloud.io/component/live-pusher |

Нативные компоненты Nvue: видео (видеоплеер)

nvue原сен компонент: video(видео) | feature/weex_videoplayer | не поддерживается | https://uniapp.dcloud.io/component/video |

Нативные компоненты Nvue: холст (холст)

nvue原生组件: canvas | feature/weex_gcanvas | не поддерживается | https://github.com/dcloudio/NvueCanvasDemo |

Исходный код конфигурации

• Модули с файлом build.gradle в папке

Клонируйте исходный код на локальный компьютер, скопируйте соответствующую папку в корневой каталог текущего проекта и добавьте конфигурацию модуля в setting.gradle. После этого выполните перестройку. Например, для модуля с картой Baidu, клонируйте текущий проект на локальный, скопируйте папку map-amap в корневой каталог проекта, откройте файл setting.gradle и в конце добавьте include "map-amap". Затем перезапустите проект. Если необходимо добавить модуль в основной проект, откройте файл build.gradle основного проекта и в разделе dependencies добавьте implementation project(path: ':map-amap').

• Модули без файла build.gradle в папке

Если в модуле нет файла build.gradle, можно просто скопировать папку модуля в корневой каталог основного проекта. Например, модуль XHR, можно скопировать папку src в основной проект src, а если есть другие папки (например, libs), просто скопируйте их содержимое в соответствующие папки основного проекта.

Обратитесь к проекту HBuilder-SourceTool-as

Конфигурация проекта и упаковка

Клонируйте проект HBuilder-SourceTool-as на локальный и запустите его напрямую. Если при запуске uni-app возникают проблемы, обратитесь к https://ask.dcloud.net.cn/article/35139.

Конфигурацию упаковки для Android можно найти по ссылке: https://www.cnblogs.com/lsdb/p/9337342.html.

Лицензия

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

1. Вы не можете взламывать, декомпилировать или реконструировать неопубликованные файлы библиотек в этом проекте.
2. Без письменного разрешения DCloud вы не можете использовать весь или часть исходного кода и файлов этого проекта для создания продуктов, конкурирующих с услугами, предоставляемыми DCloud на основе этого проекта, например, предоставление услуг разработчиков под собственной торговой маркой.
3. DCloud сохраняет за собой все права интеллектуальной собственности, включая, но не ограничиваясь, товарные знаки, патенты и авторские права, которые не передаются или совместно используются.
4. Если вы используете этот проект и создаёте собственный код и результаты, права интеллектуальной собственности принадлежат вам. Однако если вы отправляете pull request, ваш код становится открытым.
5. Если вы не нарушаете эту лицензию, вам не нужно платить DCloud за использование этого проекта.