Создание расширения microsoft edge

I see the error «We couldn’t load this extension»

This usually means that Microsoft Edge cannot access the extension folder you attempted to load.

Here is a summary of the possible errors you may encounter:

Error message	Details
Manifest parsing error: Missing or malformed manifest file.	Either the file was not found in the specified location or there is something wrong with the file. To resolve the issue, ensure that the specified folder contains the manifest at the top-level, and double-check your commas, quotes and brackets.
Manifest parsing error: must define an array.	The field should be an array. To resolve the issue, double-check your syntax. For example:
Manifest parsing error: must define value for property.	The property is required. To resolve the issue, specify the property’s value with an array of strings. For example:
Manifest parsing error: must reference at least one .css or .js file.	At least one property or is required. To resolve the issue, specify the property’s value with an array of strings. For example:
Manifest parsing error: must define value for «» property.	The property for the field is required. To resolve the issue, specify a valid value for .
Manifest parsing error: references invalid value for «run_at» field.	The property specifies an unknown value. To resolve the issue, specify one of , or . For example:
Manifest parsing error: Missing field.	The field is required. To resolve the issue, define the field with a valid value.
Manifest parsing error: Invalid field found in .	The field for the field specifies an unknown value. To resolve the issue, specify a valid value for .
Manifest parsing error: Invalid value for «» field.	The field specifies an unknown value. To resolve the issue, specify a valid value.
Manifest parsing error: Extension is not supported by current version of Microsoft Edge.	The property specifies a more recent version of Microsoft Edge than the one you own. You can find the current version by opening the «…» (More) menu and then selecting «Settings» (bottom section «About this app»). To resolve the issue, either update your browser to a newer version or change the value in the manifest. For example:
Manifest parsing error: must define value for «page» or «scripts» property.	The property «page» or «scripts» is required for the field «background». To resolve the issue, specify a string for «page» or an array of strings for «scripts». For example:
Manifest parsing error: must define value for property.	The property is required. To resolve the issue, specify a true or false value. For example:
Manifest parsing error: Only one or can be defined.	An extension cannot define both a page action and a browser action at the same time. To resolve the issue, remove either one of the definitions.
Unspecified error:	Generic catch-all error message. will be replaced by the specified error.

Localizing name and description in the Microsoft Store

Once you try to upload your complete, localized package, the Windows Dev Center will detect that more than one language is supported and check that you have corresponding localized names and descriptions for each. If any of the localized values are missing, your submission will be blocked until you provide the values.

If you are only interested in providing a localized name and description for the Microsoft Store (and not Windows), you can do so by .

Once you’ve reserved additional localized names, you can create an updated submission. In the description section you can manage additional languages for your Microsoft Store listing:

Once you’ve selected «Manage additional languages», you’ll get to select which languages you want to add to your Microsoft Store listing. The new language will show up as ‘Additional description language’ in the «Description» section.

You can click on the individual link in the «Description» section to provide a localized name and description, release notes, and visual assets for each language. The description for the Microsoft Store is not extracted from the AppXManifest. Each localized description needs to be manually entered in the Windows Dev Center:

Once the localized descriptions are submitted and the extension is published, anyone accessing a localized page of the extension in the Microsoft Store will see the following UI:

 

Office Online

Office Online is a useful app and extension for frequent office users. Using this app, you can create, edit, and even view office files in your browser. You can access the extension directly from the toolbar of Microsoft Edge from where you can get easy access to your Office files irrespective of the fact whether they are saved in your computer or online.

The extension can also open files that are saved in the apps like the OneDrive and the business version of OneDrive. It comes loaded with all the features of Word, PowerPoint, Sway, Excel, and OneNote directly on your browser without installing the MS Office software.

Price: free

Совместимость с браузерами и тестирование расширений

Иногда четность API между браузерами Chromium не существует. Например, в API идентификации и оплаты есть различия. Чтобы обеспечить соответствие расширениям ожиданиям клиентов, просмотрите состояние API в официальной документации браузера, например API Chrome, API расширения, поддерживаемые в Opera, и расширение Chrome для порта в Microsoft (Chromium) Edge.

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

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

OneNote Web Clipper

Same as the Evernote Web Clipper, the OneNote Web Clipper also helps you store an entire webpage from a website you visit. You can also save recipes and articles from a website using the extension. It basically helps you clip all or some sections of a web page that you visit, and save it to read later.

Moreover, you can also clip contents like videos, visual bookmarks, images or pdf of a page. In addition, you can access all your saved content offline from any of your devices like from a computer, phone, or tablet. Do away with clutter by organizing all content clipped minus the noise, ads, and any navigation. What’s more? You can even highlight texts, modify fonts, or add a note before you clip. You can either choose to clip the entire page or different parts of the page, based on your requirement.

Price: free

Microsoft Edge is still new and evolving, and so, we can expect more extensions to be added in the near future. For the time being, these are some of the best Microsoft Edge extensions that are extremely useful to download and save content for later use, translate foreign language, or to block unwanted ads and trackers. Select one as per your requirement and enhance your experience with Microsoft Edge browser.

Публикация расширения в магазинах веб – браузеров

Вы можете отправлять и искать расширения браузера в указанных ниже магазинах браузеров.

• Надстройки браузера Firefox
• Веб-магазин Chrome
• Надстройки для Opera
• Надстройки Microsoft Edge

В некоторых магазинах вы можете загружать перечисленные расширения из других браузеров. Загрузка из другого браузера может сэкономить время (разработчик) и удалить требование для отправки в другие магазины, если пользователи смогут переходить к существующим описаниям магазина в разных браузерах. Тем не менее, доступ к веб-браузерам не обеспечивается с помощью разных хранилищ браузеров. Чтобы убедиться в том, что пользователи смогут находить свое расширение в разных браузерах, вы должны сохранить вхождение в каждом из них в каждом хранилище расширений браузера.

Расширение может иметь наложение аудиторий, часто использующих несколько браузеров, или может быть обнаружено, что оно должно быть нацелено на аудиторию. Чтобы это произошло, существующие расширения Chromium могут быть перенесены из одного браузера в другой.

Перенос существующего расширения в Microsoft Edge

Если вы уже разработали расширение для другого браузера Chromium и хотите предоставить его для работы в Microsoft EDGE, вам не придется переписывать расширение. Миграция существующих расширений Chromium в другие браузеры Chromium очень проста, если используемые API доступны в разных браузерах или есть другие API, которые обеспечивают требуемую функциональность.

Дополнительные сведения о переносе расширения Chrome можно найти в разделе расширения Chrome для порта Microsoft (Chromium) Edge. После того как вы наносите расширение для целевого браузера, следующий шаг — опубликовать.

Публикация на веб-сайте надстроек Microsoft Edge

Чтобы приступить к публикации расширения в Microsoft EDGE, вы должны зарегистрироваться для получения учетной записи для разработчика с учетной записью электронной почты MSA \ (@outlook. com, @live. com и т. д.) для отправки списка расширений в магазине. Если вы выберете адрес электронной почты, который нужно зарегистрировать, продумайте, нужно ли передавать или предоставлять доступ к этому расширению другим пользователям в вашей организации. После завершения регистрации вы можете создать новую отправку расширения в магазине.

Чтобы отправить свое расширение в магазин, необходимо соблюдать указанные ниже требования.

• Архив \ (ZIP-файл), содержащий файлы кода.
• Все необходимые визуальные ресурсы, в том числе логотип и мелкая рекламная плитка.
• Необязательные рекламные видеоматериалы, например снимки экрана, большие рекламные плитки, URL-адрес или любое сочетание с видеороликами вашего расширения.
• Сведения, описывающие расширение, например имя, краткое описание, полное описание и ссылка на политику конфиденциальности.

Примечание

В разных магазинах могут быть разные требования к отправке. В приведенном выше списке перечислены требования для публикации расширения в Microsoft Edge.

После того как вы завершите процесс отправки, вы просматриваете свое расширение и пройдете или завершите процесс сертификации. Владельцы получают уведомление от результата, и при необходимости выполняются следующие действия. Если вы отправили в магазин обновленное расширение, в том числе обновления сведений о расширении, запускается новый процесс проверки.

Механизм Arbitrary Code Guard (ACG) на примере Microsoft Edge

Перевод

С выпуском Windows 10 Creators Update Microsoft начала использовать новый механизм безопасности в Microsoft Edge: Arbitrary Code Guard (ACG). Когда ACG применяется к процессу (в частности в процессу Microsoft Edge), в целевом процессе становится невозможным выделить новую исполняемую память или изменить существующую исполняемую память. Соответственно, исполнение произвольного кода для злоумышленника становится более сложной задачей.
Для достижения более высокой производительности современные браузеры используют JIT компиляцию (Just-In-Time) JavaScript-кода, но такой подход не совместим с ACG. Поэтому в Microsoft Edge был реализован следующий подход: JIT был выделен в отдельный процесс, относительно процесса содержимого (Content Process). Процесс содержимого посылает JIT процессу байт-код JavaScript, а JIT процесс компилирует его в машинный код и проецирует этот машинный код обратно в процесс содержимого.

Добавление содержимого и фоновых сценариев

Чтобы отключить расширение работы со страницами за пределами домена docs.Microsoft.com , перейдите на один шаг вперед и добавьте логику.

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

Этот сценарий получает URL-адрес текущей страницы и проверяет, находится ли текущая страница в домене docs.Microsoft.com . Если страница не находится в домене docs.Microsoft.com \ (например, [https://www.bing.com/] ), пути к неактивным значкам \ (Затененные значки ) отправляются в фоновый сценарий с помощью среды выполнения. SendMessage ().

Вы должны обновить файл manifest. JSON , добавив в него следующий раздел.

Определение ключа манифеста

Раздел	Сведения
content_scripts	Сведения о том, какие скрипты содержимого должен загружать браузер.

определение ключа content_scripts

Раздел	Сведения
\ (обязательно)	Шаблон URL-адреса для сопоставления перед загрузкой сценария содержимого.
	Сценарий, который должен быть загружен на совпадающие URL-адреса.
	Указывает, где были добавлены файлы JavaScript из ключа.

Затем необходимо создать . Фоновые сценарии выполняются в фоновом режиме браузера, не загружаются независимо от времени существования веб-страницы или окна браузера, и смогут общаться с помощью сценариев содержимого.

В своей папке создайте файл с именем и добавьте следующий код.

Метод Runtime. onmessage осуществляет прослушивание для Runtime. SendMessage () в скрипте содержимого. Если домен страницы не docs.Microsoft.com, метод browserAction. setIcon () задает пути к значкам для неактивных изображений.

Кроме того, сценарий отключает действие браузера \ (browserAction. Disable), чтобы пользователи не могли щелкнуть действие браузера за пределами страницы docs.Microsoft.com .

Вы должны добавить фоновый сценарий в файл manifest. JSON . Добавьте в манифест следующий раздел.

Определение ключа манифеста

Раздел	Сведения
фон	В этом разделе содержатся фоновые сценарии.

определения фоновых ключей

Раздел	Сведения
	Путь к файлу JavaScript.
(обязательно)	Это значение должно быть равно или . Если задано значение , фоновый сценарий загружается и сохраняется для всего раздела просмотра. Если задано значение , фоновый сценарий загружается с задержкой и сохраняется для сеанса просмотра.

Перезагрузите расширение и протестируйте еще раз. Чтобы перезагрузить расширение, нажмите кнопку » … » для настройки и других параметров в Microsoft EDGE, выберите расширения, щелкните расширение \ (сменщик цветов) и нажмите кнопку » загрузить расширение».

Теперь откройте новую вкладку или обновите существующую, а не docs.Microsoft.com страницу. Вы увидите значок «Неактивный» и не сможете выбрать действие браузера.

Поздравляем! Вы создали расширение Microsoft Edge! Просмотр полного примера в GitHub. Продолжайте читать, чтобы узнать больше о расширениях.

Шаг 5: Добавление сведений о вхождениях для расширения

Это сведения, которые пользователи видят при просмотре списка в надстройках Microsoft Edge. Многие поля в списке являются необязательными, но мы рекомендуем предоставить как можно больше сведений, чтобы сделать список более заметным. Минимальным требованием для вашего списка в надстройках Microsoft Edge является Complete — , и на каждом из языков, упомянутых в вашем пакете расширения.

Языки описаний в Store

Если пакет расширений поддерживает несколько языков, для каждого из них должно быть задано окно описания.
Вы должны завершить Просмотр подробных сведений \ (текстовое описание, изображения и т. д.) для каждого языка отдельно, даже если вы используете одинаковое содержимое для каждого языка. Если расширение локализовано на нескольких языках, эти языки отображаются в верхней части страницы списка.

1. Выберите один из языков в раскрывающемся списке языки .
2. Заполните сведения о листинге.
3. Нажмите кнопку Сохранить.
4. Повторите эти действия для всех поддерживаемых языков.

Примечание

Чтобы добавить или удалить языки для вашего списка в надстройках Microsoft EDGE, необходимо изменить список языков, поддерживаемых пакетом расширения, и повторно добавить его.

Возможные значения:

• : Это значение по умолчанию. Если вы не упомянули язык в пакете, мы устанавливаем язык по умолчанию на английский (США), и вы должны предоставить список на английском языке \ (США).
• ()

Отображаемое имя в магазине

Расширение имени, указанное в манифесте пакета расширения.

Примечание

Чтобы изменить имя, необходимо обновить манифест в пакете расширения и отправить его повторно.

Описание

Это поле является обязательным.
Описание пользователей о том, что делает ваше расширение.

Возможные значения:

{plain_text}: менее 10 000 знаков.

Логотип магазина

Это поле является обязательным.
Изображение 1:1 для логотипа расширения.

Возможные значения:

• 128px x 128px, PNG \ (. png )
• 150px x 140px, PNG \ (. png )
• 300px x 300px, PNG \ (. png ): Рекомендуемый размер.

Мелкая рекламная плитка

Это поле является обязательным.
Рекламная плитка для малого размера. Ваша спецификация отображается на этой плитке.

Возможные значения:

440px x 280x, PNG \ (. png )

Мультимедиа

Это поле является необязательным.
Эти ресурсы следует предоставить для более эффективного отображения продукта.

• Снимки экрана
  Изображения расширения, описывающие расширение.

• Крупные плитки для рекламы
  Крупная рекламная плитка, представляющая собой расширение в надстройках Microsoft Edge.

• URL-адрес для видео на YouTube
  Допустимый URL-адрес в YouTube для вашего расширения. Ваше видео должно иметь хорошее качество и минимальная длина. Видео YouTube должно пройти сертификацию, прежде чем публиковать расширение в надстройках Microsoft Edge. Убедитесь, что видео YouTube соответствует документу политики разработчика каталога надстроек Microsoft Edge.

Возможные значения:

• не более 10 снимков экрана.
  • 640 пикселей x 480px, PNG \ (. png ): снимки экрана.
  • 1280px x 800px, PNG \ (. png ): снимки экрана.
• 1400px x 560px, PNG \ (. png ): крупные рекламные плитки.
• 60 секунд, более короткий и 2 ГБ, URL-адрес для видео в YouTube.

Краткое описание

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

Примечание

Чтобы изменить краткое описание, необходимо обновить манифест в пакете расширения и отправить его повторно.

Условия поиска

Условия поиска — это одиночные слова или короткие фразы, которые не отображаются пользователям, но помогают сделать расширение обнаруживаемым в надстройках Microsoft Edge при поиске пользователей с помощью этих условий.

Требования

• 7 или меньше условий поиска
• не более 30 знаков на условие поиска
• 21 или меньше слов для комбинированных условий поиска

Нажмите кнопку Save (сохранить ), чтобы перейти к разделу Сохранение списка. Нажмите кнопку опубликовать , чтобы предоставить сведения об отправке.

Лучшие расширения для Microsoft Edge

Сегодня в Магазине Windows доступно 30 расширений для Edge. Многие из них не несут особой ценности в плане практичности, но есть и такие, с которыми Ваше нахождение в Интернете будет гораздо комфортнее.

Но следует помнить, что для использования большинства расширений понадобится учётная запись в соответствующих сервисах.

Блокировщики рекламы AdBlock и Adblock Plus

Это одни из популярнейших расширений на всех браузерах. AdBlock позволяет блокировать рекламу на страницах посещаемых Вами сайтов. Так Вам не придётся отвлекаться на баннеры, всплывающие окна, рекламные вставки в видео на YouTube и т.д. Для этого достаточно скачать и включить данное расширение.

В качестве альтернативы для Microsoft Edge доступен и Adblock Plus. Правда, сейчас это расширение находится в стадии ранней разработки и Microsoft предупреждает о возможных проблемах в его работе.

Веб-клипперы OneNote, Evernote и Save to Pocket

Клипперы будут полезны при необходимости быстро сохранить просматриваемую страницу или её фрагмент. Причём можно выбирать именно полезные области статьи без ненужной рекламы и панелей навигации. Сохраняться вырезки будут на сервере OneNote или Evernote (зависит от выбранного расширения).

Так выглядит использование OneNote Web Clipper:

А так – Evernote Web Clipper:

Save to Pocket имеет то же назначение, что и предыдущие варианты, – позволяет отложить на потом интересные страницы. Все сохранённые тексты будут доступны в Вашем личном хранилище.

Microsoft Translator

Удобно, когда онлайн-переводчик всегда под рукой. В этом случае речь идёт о фирменном переводчике от Microsoft, доступ к которому можно получать через расширение браузера Edge.

Значок Microsoft Translator будет отображаться в адресной строке и для перевода страницы на иностранном языке достаточно по нему кликнуть. Также можно выделять и переводить отдельные фрагменты текста.

Менеджер паролей LastPass

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

Все Ваши пароли будут храниться на сервере в зашифрованном виде. Это удобно, т.к. их можно будет использовать на другом браузере с таким же менеджером паролей.

Office Online

А это расширение обеспечивает быстрый доступ к онлайн-версии Microsoft Office. Вы в два клика можете перейти в одно из офисных приложений, создать или открыть документ, хранящийся в «облаке».

Turn Off the Lights

Предназначено для удобства просмотра видеороликов в браузере Edge. После нажатия по значку Turn Off the Lights, произойдёт автоматическая фокусировка на видео посредством затемнения остальной части станицы. Этот инструмент прекрасно работает на всех известных видеохостингах.

На данный момент Microsoft Edge не предлагает такой большой ассортимент расширений, как другие браузеры. Но всё же ряд полезных для веб-сёрфинга инструментов в Магазине Windows можно загрузить уже сегодня, конечно, если у Вас установлены необходимые обновления.

Опишите, что у вас не получилось.
Наши специалисты постараются ответить максимально быстро.

Testing an AppX package

You can test your Microsoft Edge extension AppX package by sideloading it in Microsoft Edge. Sideloading the extension AppX package is similar to sideloading a Universal Windows app. You will need to create a certificate for signing the package, and then add the package to Windows.

Signing

See How to create an app package signing certificate and How to sign an app package using SignTool for info on the signing and certification process for packages.

Note

You do not need to sign an extension package before submitting it to the Microsoft Store; the Store ingestion process will take care of that for you!

After you’ve signed the package with the certificate that you created, the certificate is still not trusted by the local machine for deployment of app packages until you install it into the trusted certificates store of the local computer. You can use Certutil.exe, which comes with Windows to do this.

To install certificates with WindowsCertutil.exe, run Cmd.exe as administrator
and run the following command:

Once the certificates are no longer in use, it is recommended that you remove them by running the following command from an administrator command prompt:

The certID is the serial number of the certificate. To determine the certificate serial number, run the following command:

Deploying

You can deploy the Microsoft Edge Extension AppX package by running the following command in PowerShell (as administrator):

Шаг 2: отправка Zip-файла расширения

На странице пакета вы отправляете ZIP-файл для отправки расширения. Вы можете добавить только один пакет за раз, поэтому, если ваше расширение не завершено, вы можете отправить его в любое время, прежде чем публиковать его. Перед загрузкой убедитесь, что ваш пакет содержит файл и прекрасно работает в Microsoft Edge.
Добавьте пакет, перетащив его в поле Отправить, или выберите команду Обзор файлов. На странице «пакет» проверяется ZIP-файл расширений и отображается сообщение о том, что Отправка завершена илизавершилась сбоем. Если пакет проходит проверку подлинности; Она успешно загружена, и вы увидите сообщение об успешном завершении. Если пакет не прошел проверку подлинности; пакет не принят, и появляется сообщение об ошибке. Если в пакете есть ошибки, устраните проблемы и попробуйте загрузить ее еще раз.

После успешной отправки ознакомьтесь со сведениями о расширении и нажмите кнопку Далее , чтобы продолжить.