- Мій код готовий, що далі?
- Структура пакета
- Package.xml
- Ручне створення пакета
- Автоматизуйте процес за допомогою пакунка grunt-umbraco
- Як завантажувати до сховища пакетів 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 Toolkit </name> <версія> 0.1 <версія> <license url = "http://opensource.org/licenses/MIT"> MIT </license> <url > http://github.com/markwemekamp/RankOne-Umbraco-SEO-Tool </url> <вимоги> <велика> 7 </major> <мінор> 4 </minor> <patch> 0 </patch> < / requirements> </package> <author> <name> Марк Wemekamp </name> <website> http://github.com/markwemekamp/ </website> </author> <readme> </readme> </ info >У файлі package.xml можна також визначити типи документів, типи даних, шаблони та інші об'єкти umbraco, які повинні бути створені під час встановлення. Я не буду пояснювати це докладно на цій посаді, тому що це виходить за рамки.
Нарешті, ви можете створити відображення в package.xml, який розміщує файли з zip-файлу у правильній директорії у вашій установці Umbraco.
<файл> <guid> styles.css </guid> <orgPath> / App_Plugins / RankOne / css </orgPath> <імя_назви> styles.css </orgName> </file>Кожен файл у zip відображається таким чином. Файли, які знаходяться в zip, але не зіставлені, не копіюються.
Ручне створення пакета
Бекенди Umbraco дозволяють створювати пакет вручну. Це можна знайти в розділі Розробник під вузлом Packages. Натисніть правою кнопкою миші "Створені пакети" і виберіть "Створити".
У майстрі можна вибрати .dll, html та інші файли. Це також чудовий спосіб експортувати доктипи та типи даних у пакет.
Після створення та публікації пакета в майстрі можна завантажити його, і ви готові завантажити його до сховища пакетів.
Це може схоже на велику роботу вручну, коли ви хочете додати нові можливості на існуючий пакет, на щастя, є хороший плагін Grunt, який автоматизує цей процес.
Автоматизуйте процес за допомогою пакунка grunt-umbraco
Я дуже рекомендую використовувати Grunt для автоматизації речей для розробки пакету, фактично я можу рекомендувати використовувати Grunt (або Gulp) на будь-яких веб-проектах. Якщо ви ще не знайомі, ви можете знайти багато великих ресурсів. Відмінне місце для початку тут .
Відмінний спосіб автоматизації упаковки - це використання плагіна Grunt з назвою "grunt-umbraco-package". Ви можете знайти вихідний код github і документацію npm можна знайти тут .
Найпростіше використання цього плагіна виглядає так:
module.exports = function (grunt) {вимагає ('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 : 'readme'}}}}); grunt.registerTask ('default', ['umbracoPackage']); };Що це робиться, всі файли в каталозі "tmp" упаковуються у файл з назвою "Ваш пакет name_01.zip", мета-дані для package.xml вказані в розділі "Параметри".
Повний приклад завдання grunt, що пакує всі файли з рішення Visual Studio, перевірте мій проект RankOne на github . Я не експерт Grunt, але ви повинні отримати уявлення про те, як ви можете використовувати його для автоматизації речей.
Велику статтю про грубування та упаковку для декількох платформ можна знайти на 24 дні .
Як завантажувати до сховища пакетів Umbraco?
Дивовижний, у вас є пакет. Давайте поділимося з рештою світу!
Насправді мені знадобилося деякий час, щоб з'ясувати, як покласти новий проект на our.umbraco.com, виявилося, що це досить просто, як тільки ви знаєте, що робити.
Спочатку вам знадобиться обліковий запис our.umbraco.org і вхід.
Перш ніж подати проект, хороша ідея створити логотип і зробити скріншоти
- Натисніть профіль (верхній праворуч) і виберіть "Редагувати профіль"
- Зліва ви побачите пункт меню "Проекти", натисніть на нього
- Майстер має 4 кроки, останній крок дозволяє зробити свій проект публічним, щоб трохи обдурити, перш ніж інші користувачі зможуть його побачити.
Майстер сам пояснює себе, тому я не буду обговорювати це більш детально
Дякуємо за читання, сподіваюся, що це було корисно. Не соромтеся залишити посилання нижче на сторінці пакета.
Мій код готовий, що далі?Створення пакета Umbraco дуже весело, але коли ви закінчите кодування і все працює на вашому локальному комп'ютері, які наступні кроки?
Як створити пакет, який можуть інсталювати інші користувачі?
Як ви його отримаєте в репозиторії пакетів Umbraco?
Мій код готовий, що далі?
Як завантажувати до сховища пакетів Umbraco?