Фреймворк Chromium Embedded Framework (CEF) — это простой фреймворк для встраивания браузеров на основе Chromium в другие приложения.

Быстрые ссылки

• Страница проекта - https://bitbucket.org/chromiumembedded/cef
• Учебник - https://bitbucket.org/chromiumembedded/cef/wiki/Tutorial
• Общее использование - https://bitbucket.org/chromiumembedded/cef/wiki/GeneralUsage
• Быстрый старт сборки Master - https://bitbucket.org/chromiumembedded/cef/wiki/MasterBuildQuickStart
• Ветки и сборка - https://bitbucket.org/chromiumembedded/cef/wiki/BranchesAndBuilding
• Объявления - https://groups.google.com/forum/#!forum/cef-announce
• Форум поддержки - http://www.magpcss.org/ceforum/
• Документация API C++ для CEF1 - http://magpcss.org/ceforum/apidocs/
• Документация API C++ для CEF3 - http://magpcss.org/ceforum/apidocs3/
• Загрузки - https://cef-builds.spotifycdn.com/index.html
• Пожертвования - http://www.magpcss.org/ceforum/donate.php # Введение CEF — это проект с открытым исходным кодом под лицензией BSD, основанный Маршаллом Гринблаттом в 2008 году и базирующийся на проекте Google Chromium. В отличие от самого проекта Chromium, который主要集中于Google Chrome应用程序的开发，CEF专注于在第三方应用程序中促进嵌入式浏览器的使用案例。CEF通过提供生产质量稳定的API、跟踪特定Chromium版本的发布分支和二进制分发，将用户与底层Chromium和Blink代码的复杂性隔离开来。CEF中的大多数功能都有默认实现，提供了丰富的功能，同时要求用户进行最少或无需集成工作。目前，全球有超过1亿个CEF实例安装在各种公司和行业的产品中。CEF的部分用户列表可在CEF维基百科页面上找到。CEF的一些使用场景包括：
• 在现有的原生应用程序中嵌入符合HTML5标准的Web浏览器控件。
• 创建一个轻量级的原生“外壳”应用程序，主要使用Web技术开发用户界面。
• 在具有自定义绘图框架的应用程序中“离屏”渲染Web内容。
• 作为现有Web属性和应用程序自动化测试的主机。

Введение

CEF — это проект с открытым исходным кодом под лицензией BSD, основанный Маршаллом Гринблаттом в 2008 году и базирующийся на проекте Google Chromium. В отличие от самого проекта Chromium, который сосредоточен на разработке приложения Google Chrome, CEF фокусируется на продвижении использования встроенных браузеров в сторонних приложениях. CEF через предоставление производственного качества стабильных API, отслеживание выпускаемых веток конкретных версий Chromium и двоичные дистрибутивы, изолирует пользователей от сложности нижележащего кода Chromium и Blink. Большинство функций в CEF имеют реализацию по умолчанию, что обеспечивает богатый функционал, требуя от пользователей минимальной или вообще никакой работы по интеграции. В настоящее время более 100 миллионов экземпляров CEF установлены в продуктах различных компаний и отраслей. Частичный список пользователей CEF можно найти на странице вики CEF. Некоторые сценарии использования CEF включают:

• Встраивание соответствующих стандарту HTML5 веб-браузерных компонентов в существующие нативные приложения.

• Создание легковесного нативного «оболочки» приложения, в основном используя веб-технологии для разработки пользовательского интерфейса.

• «Офф-скрин» рендеринг веб-контента в приложениях с пользовательским графическим фреймворком.

• Использование в качестве хоста для автоматизированного тестирования существующих веб-сайтов и приложений.(Note: The last paragraph was partially translated incorrectly due to a mix-up in the source text. Here is the corrected version in Russian:)

• Встраивание в существующее нативное приложение HTML5-совместимого веб-браузера.

• Создание легковесного нативного «оболочки» приложения, которое в основном использует веб-технологии для разработки пользовательского интерфейса.

• Отображение веб-контента «вне экрана» в приложениях, имеющих свои собственные пользовательские графические фреймворки.

• Выступление в качестве хоста для автоматизированного тестирования существующих веб-сайтов и приложений. CEF поддерживает широкий диапазон языков программирования и операционных систем и может легко интегрироваться как в новые, так и в существующие приложения. Он был разработан с нуля с учетом как производительности, так и удобства использования. Базовая платформа включает интерфейсы программирования на языках C и C++, представленные через нативные библиотеки, которые изолируют приложение-хост от деталей реализации Chromium и Blink. CEF обеспечивает тесную интеграцию между браузером и приложением-хостом, включая поддержку пользовательских плагинов, протоколов, объектов JavaScript и расширений JavaScript. Приложение-хост может опционально контролировать загрузку ресурсов, навигацию, контекстные меню, печать и многое другое, при этом используя ту же производительность и технологии HTML5, которые доступны в веб-браузере Google Chrome.Множество людей и организаций вкладывают время и ресурсы в поддержку разработки CEF, но всегда приветствуется большее участие сообщества. Это включает поддержку как основного проекта CEF, так и внешних проектов, которые интегрируют CEF с дополнительными языками программирования и фреймворками (см. раздел "Внешние проекты" ниже). Если вы заинтересованы в пожертвовании своего времени для помощи в разработке CEF, см. раздел "Помощь" ниже. Если вы заинтересованы в пожертвовании денег для поддержки общих усилий по разработке и инфраструктуре CEF, посетите страницу Пожертвования CEF.

Начало работы

Новым пользователям, начинающим работу с CEF, следует начать с чтения страницы Вики Учебник для обзора использования CEF, а затем перейти к странице Вики Общее использование для более подробного обсуждения архитектурных и эксплуатационных вопросов. Полная документация API доступна здесь. Поддержка CEF и связанные обсуждения доступны на Форуме CEF.# Бинарные дистрибутивы Бинарные дистрибутивы, которые включают все необходимые файлы для сборки приложения на основе CEF, доступны на странице Загрузки. Бинарные дистрибутивы являются автономными и не требуют скачивания исходного кода CEF или Chromium. Файлы символов для отладки бинарных дистрибутивов libcef также можно скачать по вышеуказанным ссылкам.# Исходные дистрибутивы Проект CEF является расширением проекта Chromium. CEF поддерживает ветки разработки и выпуска, которые отслеживают ветки Chromium. Исходный код CEF можно скачать, собрать и упаковать вручную или с помощью автоматизированных инструментов. Подробную информацию см. на странице Wiki BranchesAndBuilding.

Внешние проекты

Базовая платформа CEF включает поддержку языков программирования C и C++. Благодаря усилиям внешних разработчиков CEF может интегрироваться с рядом других языков программирования и фреймворков. Эти внешние проекты не поддерживаются CEF, поэтому, если у вас есть вопросы или проблемы, пожалуйста, свяжитесь с соответствующими разработчиками проектов.

• .NET (CEF3) - https://github.com/cefsharp/CefSharp
• .NET (CEF1) - https://bitbucket.org/fddima/cefglue
• .NET/Mono (CEF3) - https://gitlab.com/xiliumhq/chromiumembedded/cefglue
• Delphi - https://github.com/hgourvest/dcef3
• Delphi - https://github.com/salvadordf/CEF4Delphi
• Go - https://github.com/CzarekTomczak/cef2go
• Java - https://bitbucket.org/chromiumembedded/java-cef
• Python - http://code.google.com/p/cefpython/

Если вы являетесь разработчиком проекта, который не указан выше, и хотите, чтобы ваш проект был добавлен в список, пожалуйста, опубликуйте сообщение на форуме CEF или свяжитесь с Маршаллом напрямую.## Как помочь CEF все еще находится в активной разработке. Вот несколько способов, как вы можете помочь:

• Голосуйте за задачи в трекере задач CEF, которые важны для вас. Это помогает приоритизировать разработку.
• Сообщайте о найденных ошибках или важных для вас запросах на новые функции. Убедитесь, что перед созданием новых задач вы проверили наличие существующих. Для вопросов по использованию используйте форум CEF, а не трекер задач. Каждая задача CEF должна:

• Включать ревизию CEF или версию бинарного дистрибутива.
• Содержать информацию о вашей ОС и версии компилятора.
• Если задача является ошибкой, предоставьте подробную информацию о воспроизведении.
• Если задача является новой функцией, опишите, почему эта функция полезна.

• Напишите юнит-тесты для новых или существующих функций.
• Приветствуются pull-запросы и патчи. Просмотрите открытые задачи в трекере задач CEF status=new&status=open) или ищите TODO(cef) в исходном коде для идей. Если вы хотите внести изменения в исходный код CEF, пожалуйста, следуйте нижеприведенным рекомендациям:
• Создайте или найдите подходящую задачу для каждого отдельного бага, функции или изменения.
• Отправьте pull request или создайте патч с вашими изменениями и прикрепите его к задаче CEF.Изменения должны:

• Быть отправлены против текущей CEF master ветки, если явно не исправляют баг в ветке релиза CEF.
• Следовать стилю существующих исходных файлов CEF. В общем случае CEF использует стиль кодирования Chromium.
• Включать новые или измененные юнит-тесты, если это уместно для функциональности.
• Не включать ненужные или не связанные изменения.