Publikowanie pierwszego pakietu Umbraco

1. Mój kod jest gotowy, co dalej?
2. Struktura pakietu
3. Package.xml
4. Ręczne tworzenie pakietu
5. Zautomatyzuj proces za pomocą pakietu grunt-umbraco
6. Jak przesłać do repozytorium pakietów Umbraco?

Tworzenie pakietu Umbraco to mnóstwo zabawy, ale kiedy skończysz kodowanie i wszystko działa płynnie na lokalnym komputerze, jakie są kolejne kroki?

Jak utworzyć pakiet, który inni ludzie mogą zainstalować? Jak uzyskać go w repozytorium pakietów Umbraco?

Nie tak dawno miałem te same pytania i po kilku badaniach odkryłem to. Oto samouczek krok po kroku, jak dostać się z lokalnego pakietu Umbraco do repozytorium pakietu Umbraco.

Mój kod jest gotowy, co dalej?

Twój pakiet jest zainstalowany na twoim lokalnym komputerze i przetestowany na twoim lokalnym komputerze i jesteś gotowy, aby go spakować i rozpowszechnić, aby inni mogli z niego korzystać.

Struktura pakietu

Czym jest pakiet Umbraco? Pakiet Umbraco to archiwum zip zawierające jeden lub więcej następujących elementów:

• Plik package.xml
• Plik package.manifest
• Kod serwera, taki jak pliki .dll
• Kod klienta (pliki .css, .js i .html)

Package.xml

Plik package.xml jest plikiem używanym przez Umbraco do identyfikacji nazwy, wersji, licencji i innych metadanych pakietu.

Przykład struktury informacji o pakiecie:

<info> <pakiet> <nazwa> RankOne - Zestaw narzędzi SEO </name> <wersja> 0.1 </version> <licencja url = "http://opensource.org/licenses/MIT"> MIT </license> <url > http://github.com/markwemekamp/RankOne-Umbraco-SEO-Tool </url> <wymagania> <major> 7 </major> <minor> 4 </minor> <patch> 0 </patch> < / wymagania> </package> <author> <name> Mark Wemekamp </name> <website> http://github.com/markwemekamp/ </website> </author> <readme> </readme> </ info >

W pliku package.xml można również zdefiniować typy dokumentów, typy danych, szablony i inne elementy umbraco, które powinny zostać utworzone podczas instalacji. Nie wyjaśnię tego szczegółowo w tym poście, ponieważ jest to rodzaj poza zakresem.

Wreszcie możesz utworzyć mapowanie w pliku package.xml, który umieszcza pliki z pliku zip w odpowiednim katalogu w instalacji Umbraco.

<plik> <guid> styles.css </guid> <ścieżkaProgramu> / App_Plugins / RankOne / css </orgPath> <orgName> styles.css </orgName> </file>

Każdy plik zip jest mapowany w ten sposób. Pliki znajdujące się w zipie, ale nie odwzorowane, nie zostaną skopiowane.

Ręczne tworzenie pakietu

Backendy Umbraco umożliwiają ręczne utworzenie pakietu. Można to znaleźć w sekcji Developer w węźle Pakiety. Kliknij prawym przyciskiem myszy „Utworzono pakiety” i wybierz „Utwórz”.

W kreatorze możesz wybrać pliki .dll, html i inne. Jest to również świetny sposób na eksportowanie typów dokumentów i typów danych do pakietu.

Po utworzeniu i opublikowaniu pakietu w kreatorze możesz go pobrać i możesz go przesłać do repozytorium pakietów.

Może to być tak samo jak wiele pracy ręcznej, gdy chcesz dodać nowe funkcje do istniejącego pakietu, na szczęście istnieje ładna wtyczka Grunt, która automatyzuje ten proces.

Zautomatyzuj proces za pomocą pakietu grunt-umbraco

Mogę bardzo polecić użycie Grunt do automatyzacji tworzenia pakietów, właściwie mogę polecić używanie Grunt (lub Gulp) w projektach związanych z Internetem. Jeśli jeszcze się nie znasz, możesz znaleźć wiele wspaniałych zasobów. Doskonałym miejscem do rozpoczęcia jest tutaj .

Świetnym sposobem na automatyzację pakowania jest użycie gruntownej wtyczki o nazwie „grunt-umbraco-package”. Możesz znaleźć kod źródłowy github i dokumentację npm można znaleźć tutaj .

Najprostsze użycie tej wtyczki wygląda tak:

module.exports = function (grunt) {require ('load-grunt-tasks') (grunt); grunt.initConfig ({umbracoPackage: {dist: {src: 'tmp', dest: 'pkg', opcje: {nazwa: "Twoja nazwa pakietu", wersja: '1.0', url: 'http: // twój-pakiet -website.com ', license:. MIT', licenseUrl: 'http://opensource.org/licenses/MIT', autor: 'twoje imię', autorUrl: 'htt: //your-website.com', readme : 'readme'}}}}); grunt.registerTask ('default', ['umbracoPackage']); };

To, co to robi, to że wszystkie pliki w katalogu „tmp” są spakowane do pliku o nazwie „Twoja nazwa pakietu_01.zip”, metadane dla pliku package.xml są określone w sekcji opcji.

Kompletny przykład zadania gruntującego, które pakuje wszystkie pliki z rozwiązania Visual Studio, sprawdź mój projekt RankOne pod adresem github . Nie jestem ekspertem Grunt, ale powinieneś dowiedzieć się, w jaki sposób możesz go użyć do automatyzacji.

Na stronie można znaleźć świetny artykuł na temat chrząknięcia i pakowania dla wielu platform 24 dni .

Jak przesłać do repozytorium pakietów Umbraco?

Niesamowite, masz pakiet. Podzielmy się nim z resztą świata!

Dopiero po chwili dowiedziałem się, jak umieścić nowy projekt na naszej stronie .umbraco.com, okazuje się, że jest to dość proste, kiedy już wiesz, co robić.

Najpierw będziesz potrzebował konta nasz.umbraco.org i zaloguj się.

Zanim prześlesz swój projekt, dobrze jest stworzyć logo i zrobić kilka zrzutów ekranu

1. Kliknij swój profil (u góry po prawej) i wybierz „Edytuj profil”
2. Po lewej stronie zobaczysz element menu o nazwie „Projekty”, kliknij go
3. Kreator składa się z 4 kroków, ostatni krok pozwala na upublicznienie projektu, dzięki czemu możesz się trochę nabrać, zanim inni ludzie go zobaczą

Sam czarodziej jest dość oczywisty. Myślę, że nie będę omawiał tego bardziej szczegółowo

Dzięki za przeczytanie, mam nadzieję, że to było pomocne. Nie wahaj się zostawić linku poniżej do swojej strony pakietu.