В этой статье описано, как создать собственную версию Chromium Embedded Framework (CEF) для использования с программными продуктами Google на основе проекта CEF с открытым исходным кодом.
Такие продукты Google собраны на разных версиях CEF. При каждом обновлении продукта эти версии могут меняться. Перед созданием сборки рекомендуем проверить, какая версия CEF используется в продукте Google, в разделе с описанием этого продукта. Если версии CEF различаются, могут возникнуть проблемы с совместимостью.
После создания собственной сборки вы можете использовать ее, скопировав исполняемые файлы в каталог установки продукта. Структура папок с исполняемыми файлами должна совпадать со структурой папок приложения, для которого была создана сборка CEF.
Инструкции для сотрудников Google
Если вы сотрудник Google, вместо этого перейдите по ссылке go/cef.
Как создать сборку, используя официальный репозиторий CEF
Фреймворк CEF размещен на сайте Bitbucket по адресу https://bitbucket.org/chromiumembedded/cef. На этом ресурсе есть вики-страница с информацией о создании сборок CEF. Все продукты Google, в которых используется CEF, построены на ветвях выпусков CEF. На этой странице можно найти инструкции по созданию сборки из ветви выпуска. Сборки CEF в значительной степени основаны на проекте Chromium с открытым исходным кодом. По этой причине системные требования для создания сборок CEF могут быть очень высокими.
При создании сборок CEF Google использует модифицированную версию скрипта на языке Python для автоматизированной сборки, который применяет дополнительные исправления исходного кода. Для сборки версии CEF, совместимой с продуктами Google на основе CEF, использовать эти исправления необязательно, но при желании их можно найти на сайте https://third-party-mirror.googlesource.com/cef. Там продублированы в общем доступе все файлы, использованные Google для сборки CEF.
Как использовать метод CEF для автоматизированной сборки
Чтобы создать сборку, используя автоматизированный процесс CEF, следуйте инструкциям на этой странице. Не забудьте указать нужную ветвь выпуска для совместимости с версией CEF в продукте Google, под который создается сборка.
Как использовать исправления Google
Чтобы создать сборку, применив исправления, используемые Google, выполните следующие действия:
- Следуйте обычному процессу автоматизированной сборки CEF. Запустите синхронизацию с правильным источником ветви выпуска.
- Скачайте отзеркалированные файлы исправлений и добавьте их в уже существующую папку по адресу
cef/patches
. Следуйте инструкциям из файлаREADME.txt
, где описано, как добавить исправления и как добавить их упоминания в файл конфигурации исправлений. - Запустите процесс сборки CEF с помощью скрипта
automated_git.py
.
Как включить в сборку проприетарные кодеки Chrome
Сборка CEF по умолчанию не включает проприетарные аудио- и видеокодеки. Чтобы создать сборку CEF с включенными в нее кодеками Chrome, необходимо добавить код ffmpeg_branding=Chrome proprietary_codecs=true
в переменную среды GN_DEFINES
.
Обратите внимание, что для использования дополнительных кодеков необходимо принять лицензионные соглашения и оплатить комиссии держателям патентов на эти кодеки.
Как использовать сборки CEF с официальной страницы
Официальная страница сборок CEF размещена на сайте Spotify: http://opensource.spotify.com/cefbuilds/index.html. На этой странице можно скачивать сборки ветвей выпусков для трех платформ (Windows, Mac and Linux). Скачанный файл можно распаковать и скопировать в каталог установки продукта Google.