Публикация вашего первого пакета Umbraco

1. Мой код готов, что дальше?
2. Структура пакета
3. Package.xml
4. Создание пакета вручную
5. Автоматизируйте процесс с помощью grunt-umbraco-package
6. Как загрузить в хранилище пакетов Umbraco?

Создание пакета Umbraco доставляет массу удовольствия, но как только вы закончите писать код, и все будет работать на вашем локальном компьютере, каковы будут следующие шаги?

Как создать пакет, который могут установить другие люди? Как вы получаете его в хранилище пакетов Umbraco?

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

Мой код готов, что дальше?

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

Структура пакета

Так что же такое пакет Umbraco? Пакет Umbraco - это zip-архив, содержащий один или несколько следующих элементов:

• Файл package.xml
• Файл package.manifest
• Серверный код, такой как DLL-файлы
• Код клиента (файлы .css, .js и .html)

Package.xml

Package.xml - это файл, который Umbraco использует для идентификации имени, версии, лицензии и других метаданных пакета.

Пример структуры информации о пакете:

<info> <package> <name> RankOne - Инструментарий SEO </ name> <версия> 0.1 </ version> <license url = "http://opensource.org/licenses/MIT"> MIT </ license> <url > http://github.com/markwemekamp/RankOne-Umbraco-SEO-Tool </ url> <требования> <мажор> 7 </ major> <минор> 4 </ minor> <патч> 0 </ patch> < / требования> </ package> <автор> <имя> Марк Wemekamp </ name> <веб-сайт> http://github.com/markwemekamp/ </ website> </ author> <readme> </ readme> </ info >

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

Наконец, вы можете создать отображение в файле package.xml, которое помещает файлы из zip-файла в правильный каталог в вашей установке Umbraco.

<file> <guid> styles.css </ guid> <orgPath> / App_Plugins / RankOne / css </ orgPath> <orgName> styles.css </ orgName> </ file>

Каждый файл в zip отображается таким образом. Файлы, которые находятся в zip, но не отображаются, не будут скопированы.

Создание пакета вручную

Бэкэнды Umbraco позволяют вам создавать пакеты вручную. Это можно найти в разделе «Разработчик» в разделе «Пакеты». Щелкните правой кнопкой мыши «Созданные пакеты» и выберите «Создать».

В мастере вы можете выбрать .dll, HTML и другие файлы. Это также отличный способ экспортировать типы документов и типы данных в пакет.

После того как вы создали и опубликуете пакет в мастере, вы можете загрузить его, и вы готовы выгрузить его в репозиторий пакетов.

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

Автоматизируйте процесс с помощью grunt-umbraco-package

Я настоятельно рекомендую использовать Grunt для автоматизации процессов разработки пакетов, на самом деле я могу порекомендовать использовать Grunt (или Gulp) в любых веб-проектах. Если вы еще не знакомы, есть много отличных ресурсов, которые вы можете найти. Отличное место для начала Вот ,

Отличный способ автоматизировать упаковку - использовать плагин grunt с именем «grunt-umbraco-package». Вы можете найти исходный код на GitHub и документацию npm можно найти Вот ,

Самое простое использование этого плагина, выглядит так:

module.exports = function (grunt) {require ('load-grunt-tasks') (grunt); grunt.initConfig ({umbracoPackage: {dist: {src: 'tmp', dest: 'pkg', параметры: {name: "Имя вашего пакета", версия: '1.0', url: 'http: // your-package -website.com ', лицензия:. MIT', licenseUrl: 'http://opensource.org/licenses/MIT', автор: 'ваше имя', authorUrl: 'htt: //your-website.com', readme : 'Прочти меня' } } } }); grunt.registerTask ('default', ['umbracoPackage']); };

Для этого все файлы в каталоге «tmp» упакованы в файл с именем «Ваш пакет name_01.zip», метаданные для package.xml указаны в разделе опций.

Полный пример выполнения задачи, которая упаковывает все файлы из решения Visual Studio, можно найти в моем проекте RankOne по адресу GitHub , Я не эксперт Grunt, но вы должны понять, как вы можете использовать его для автоматизации вещей.

Отличную статью о грунте и упаковке для нескольких платформ можно найти на 24days ,

Как загрузить в хранилище пакетов Umbraco?

Круто, у тебя есть посылка. Давайте поделимся этим с остальным миром!

На самом деле мне потребовалось некоторое время, чтобы понять, как разместить новый проект на нашем сайте.umbraco.com. Оказывается, это довольно просто, когда вы знаете, что делать.

Сначала вам понадобится аккаунт на our.umbraco.org и войти.

Перед тем, как отправить проект, рекомендуется создать логотип и сделать несколько снимков экрана.

1. Нажмите на свой профиль (вверху справа) и выберите «Редактировать профиль»
2. Слева вы увидите пункт меню под названием «Проекты», щелкните его
3. Мастер имеет 4 шага, последний шаг позволяет вам сделать ваш проект общедоступным, чтобы вы могли немного дурачиться, прежде чем его увидят другие люди.

Сам мастер довольно понятен, я думаю, поэтому я не буду обсуждать это более подробно

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

Похожие

Комментарии