Przejdź do głównej zawartości

UWP Community Toolkit — niezbędnik dewelopera Universal Windows Platform

Tworzenie aplikacji na najświeższą platformę Windows (Universal Windows Platform) nie powinno sprawiać dużych problemów nawet początkującym osobom w tym temacie. Warto jednak już od pierwszych kroków wyposażyć się w ciekawy zbiór bibliotek od Microsoftu, który uprzyjemni pracę w UWP. Zróżnicowany zestaw pomocnych elementów znacznie usprawni programowanie na platformie Windows.

desk

UWP Community Toolkit - niezbędnik dewelopera

Pomimo rozbudowanego SDK pod UWP (a jednocześnie ograniczonego, niestety) gigant z Redmond postanowił zebrać w jednym miejscu wszystkie dodatki, jakie mogą przydać się przy tworzeniu aplikacji. Znajdziemy tu zarówno rozwiązania pracowników giganta z Redmond jak i biblioteki, które wcześniej tworzone były przez niezależnych pasjonatów.Tak właśnie powstał UWP Community Toolkit, który rozwijany jest przez Microsoft ze społecznością deweloperów.

Projekt jest całkowicie darmowy, a jego źródła wrzucone są na GitHuba. UWP Community Toolkit podzielono na kilka bibliotek, które dołączmy szybko do projektu poprzez Nugeta wpisując Microsoft.Toolkit.UWP .

desk

W celu dodania pakietu do istniejącego projektu należy pamiętać, iż projekt UWP musi być kompatybilny z Windows SDK co najmniej w wersji 10586. Toolkit współgra z całą platformą bazującą na Windows 10 czyli PC, Mobile, XBOX, IoT i HoloLens. Microsoft postarał się także, aby udostępnić całkiem wyczerpującą dokumentację. Zestaw może być użyty zarówno przez osoby piszące w C# jak i VB.NET (też jest coś do JS).

Aktualna wersja nosi numerek 1.2, a w lutym planowane jest wydanie wersji 1.3 z poprawkami błędów, nowymi kontrolkami czy obsługa OneDrive.

Co w zestawie?

Toolkit został podzielony na kilka paczek:

  • Microsoft.Toolkit.Uwp - główna biblioteka z niezbędnymi dodatkami, zawiera ułatwienia przy używaniu Storage, Http response/request, wykrywaniu sieci/Internetu itd.

  • Microsoft.Toolkit.Uwp.Notifications - paczka wspomagająca tworzenie powiadomień toast i żywych kafelków

  • Microsoft.Toolkit.Uwp.Notifications.Javascript - paczka jak wyżej, ale pod JS

  • Microsoft.Toolkit.Uwp.Services - obsługa zewnętrznych serwisów Bing, Facebook, LinkedIn, Microsoft Graph oraz Twitter

  • Microsoft.Toolkit.Uwp.UI - biblioteka oferuje zestaw dodatków do UI w XAML, jak np. gotowy zbiór konwerterów czy wyszukiwanie po drzewie XAML

  • Microsoft.Toolkit.Uwp.UI.Animations - zbiór animacji

  • Microsoft.Toolkit.Uwp.UI.Controls - 16 nowych kontrolek, które rozszerzają dostępne kontroli XAML z SDK, jak np. HamburgerMenu, AdaptiveGridView czy MasterDetailsView

desk

Trzeba przyznać, że jest tego całkiem sporo i ciężko jest do czegoś się przyczepić. W razie jeśli gotowy kod nie spełnia naszych oczekiwać możne go zmienić/rozszerzyć bazując na kodzie źródłowym.

Poszczególne dodatki nie są niczym rewolucyjnym, ale pozwalają na efektywniejsze tworzenie aplikacji na platformę UWP. Sprawdźmy szybko dwa przykłady.

Weźmy pod lupę kontrolkę HamburgerMenu z toolkitu. Jest ona niczym innym jak znacznie rozszerzoną wersją standardowej kontrolki SplitView z SDK. Niby nic wielkiego, ale o ile przyspieszy zbudowanie aplikacji bazującej na menu z hamburgerem .

Podobnie jest z helperem do powiadomień toast. Standardowo, aby wyświetlić powiadomienie musimy przekazać do metody XMLa. Zatem aby pokazać powiadomienie z przypomnieniem:

desk

Do metody należy dostarczyć taki oto XML:


<toast launch="action=viewEvent&amp;eventId=1983" scenario="reminder">
  
  <visual>
    <binding template="ToastGeneric">
      <text>Adaptive Tiles Meeting</text>
      <text>Conf Room 2001 / Building 135</text>
      <text>10:00 AM - 10:30 AM</text>
    </binding>
  </visual>

  <actions>
    
    <input id="snoozeTime" type="selection" defaultInput="15">
      <selection id="1" content="1 minute"/>
      <selection id="15" content="15 minutes"/>
      <selection id="60" content="1 hour"/>
      <selection id="240" content="4 hours"/>
      <selection id="1440" content="1 day"/>
    </input>

    <action
      activationType="system"
      arguments="snooze"
      hint-inputId="snoozeTime"
      content=""/>

    <action
      activationType="system"
      arguments="dismiss"
      content=""/>
    
  </actions>
  
</toast>

Niby nic wielkiego, ale musimy usiąść z dokumentacją i "ręcznie" stworzyć takiego XMLa, jednocześnie zapominając o intellisense czy walidacji błędów podczas pisania.

W tym przypadku z pomocą przyjdzie nam UWP Community Toolkit. Pakiet dostarczy odpowiednią strukturę klas, która będzie w stanie wygenerować na jej podstawie XMLa:


var xml = new ToastContent()
    {
        Launch = "action=viewEvent&eventId=1983",
        Scenario = ToastScenario.Reminder,

        Visual = new ToastVisual()
        {
            BindingGeneric = new ToastBindingGeneric()
            {
                Children =
                {
                    new AdaptiveText()
                    {
                        Text = "Adaptive Tiles Meeting"
                    },

                    new AdaptiveText()
                    {
                        Text = "Conf Room 2001 / Building 135"
                    },

                    new AdaptiveText()
                    {
                        Text = "10:00 AM - 10:30 AM"
                    }
                }
            }
        },

        Actions = new ToastActionsCustom()
        {
            Inputs =
            {
                new ToastSelectionBox("snoozeTime")
                {
                    DefaultSelectionBoxItemId = "15",
                    Items =
                    {
                        new ToastSelectionBoxItem("1", "1 minute"),
                        new ToastSelectionBoxItem("15", "15 minutes"),
                        new ToastSelectionBoxItem("60", "1 hour"),
                        new ToastSelectionBoxItem("240", "4 hours"),
                        new ToastSelectionBoxItem("1440", "1 day")
                    }
                }
            },

            Buttons =
            {
                new ToastButtonSnooze()
                {
                    SelectionBoxId = "snoozeTime"
                },

                new ToastButtonDismiss()
            }
        }
    }.GetXml();


Szybko i praktycznie bez zaglądania do dokumentacji, stworzymy podstawowe powiadomienie. Można zastanowić się, dlaczego takie rozwiązanie nie jest standardowo udostępnione w SDK.

Warto dodać, że wykorzystanie biblioteki jest niezmiernie proste i przyjemne, a to dzięki...

UWP Community Toolkit Sample App

Świetnym dodatkiem do omawianego pakietu jest aplikacja UWP Community Toolkit Sample App dostępna w markecie Windows. Warto ją pobrać, aby na żywo przetestować jak działają poszczególne elementy. Sprawdzimy działanie kontrolek, notyfikacji czy helperów. Dodatkowo z działającym przykładem umieszczony jest obok kod, który odpowiada za przedstawioną funkcjonalność.

desk

Pakiet UWP Community Toolkit będzie idealnym wyborem dla osób rozpoczynających przygodę z UWP, jak i dla tych, którzy są już zaznajomieni z tematem. Pierwsi zyskają szybki start do nowej platformy, drudzy również przyspieszą deweloping, a dodatkowo odnajdą kilka ciekawych rozwiązań do wykorzystania we własnych implementacjach.

Cały toolkit jest niezmiernie ciekawy, a w kilku przypadkach można się zastanowić dlaczego dane elementy nie są standardowo wbudowane w SDK.

Komentarze

Popularne posty z tego bloga

Licznik Blogowy - wersja 0.6, czyli własne statystyki i wykresy tuż pod ręką

Zapewne wielu z Was pamiętam, a może i używa:) , mojej wtyczki Licznik Blogowy do najpopularniejszych przeglądarek, skierowanej do blogerów na portalu dobreprogramy.Jeśli ktoś nie kojarzycie, to w skrócie: Licznik Blogowy to wtyczka do Chroma/Opery/Firefoxa. Za jej pomocą przejrzycie szybko pełne statystyki swoich wpisów na blogu. Lista wpisów może być sortowana wg: ilości wyświetleń, ilości komentarzy, daty publikacji i adnotacji moderacji. Łatwo znajdziecie publikacje, oznaczone przez moderatorów, a to wszystko w estetycznej i miłej formie, dostosowanej do wybranej skórki na blogu.Licznik Blogowy 0.6 - czas na własne wykresy! :)Ostatnia odsłona wtyczki przyniosła ciekawe refleksje po rozmowie z szanownym Panem Mordziem. Zaproponował on, aby wtyczka mogła generować wykresy na podstawie zebranych danych. Pomysł wydał mi się niezmiernie interesujący, stąd też obecna aktualizacja (0.6) przynosi możliwość tworzenia wykresów, opierając się na zabranych danych.Używanie nowej funkcji jes…

Humble Voxatron Debut + tanie gry

Ponownie The Humble Indie Bundle atakuje nas świetną promocją.W skrócie czym jest Humble Indie Bundle:kupujesz gry za dowolne pieniądzegry są multiplatformowebrak zabezpieczeńpieniądze idą m.in. na cele charytatywnePod http://www.humblebundle.com/ znajdziecie więcej szczegółów.W nowej odsłonie The Humble Indie Bundle, która obecnie zwie się: Humble Voxatron Debut możemy otrzymać Voxatron, a także jeśli wpłata przekroczy średnią aktualnych wpłat: The Binding of Isaac i Blocks That Matter.VoxatronTytułowa pozycja to strzelanka z rzutem izometrycznym. Grę otrzymujemy w wersji alfa. Jest to jednocześnie pra-premiera. Nie posiada ona jednak jakiś znaczących defektów, przez co można spokojnie grać :) Mamy również gwarancję, iż będziemy dostawać wszelkie aktualizacje i dodatki, jakie otrzyma.Voxatron przy pierwszym uruchomieniu zachwyca, śwetną oprawą muzyczną. Tytułowy motyw z menu, przypomina stare czasy, kiedy muzykę z menu nuciło się jeszcze długo po tym jak wyłączyliśmy grę.Nie sposób …

222 polskie gry, które warto znać - Marcin Kosman, recenzja książki

Marcin Kosman dał się poznać jako autor ciekawej pozycji o polskim game devie: "Nie tylko Wiedźmin. Historia polskich gier komputerowych". Po pięciu latach wraca z nową książką, również związaną z polską branżą grową, ale w zupełnie innej formie.222 polskie gry"222 polskie gry, które warto znać" to wyjątkowa książka. Co więcej, to nie jest książka jako taka, a bliżej jej do albumu. W języku angielskim funkcjonują one jako tzw. "Coffee table books", czyli książki/albumy bardziej do oglądania, niż do czytania.Tak jest właśnie z omawianą pozycją. W twardych okładach, w formacie B5 i na pięknym, kredowym papierze, znalazło się 222 polskich gier z lat 1983-2019. Każda strona to duża grafika, z kilkoma zdaniami o grze od autora książki, a czasem również dodatkowy, akapitem od osób tworzących dany kawałek softu.Wybór gier jest na tyle szeroki, że można śmiało powiedzieć, iż wybrano faktycznie najbardziej znaczące i rozpoznawalne tytuły. Jako, że przygodę zacząłe…

Nokia Lumia 900 - recenzja najmocniejszego smartfona od Finów

Za nami już prezentacja nowego Windows Phone 8 oraz kilku urządzeń działających pod tym systemem. Takie cuda jak Nokia Lumia 920 / 820, HTC 8X / 8S, czy sporych rozmiarów Samsung Ativ S (4.8 calowy ekran) są marzeniem wielu z nas. Obecnie jednak ceny są dość wysokie (chociaż HTC 8S ma być już za 1300 zł..., tylko to nie Lumia... o czym na końcu tego wpisu), a i dostępność urządzeń na naszym rynku pozostawia wiele do życzenia. Cóż można zrobić w takiej sytuacji? Otóż nic nie stoi na przeszkodzie, aby zakupić jedną z najlepszych słuchawek jakie wyszły w tym roku. Mowa oczywiście o Nokia Lumia 900, która pomimo tego, iż posiada Windows Phone 7, jest niesamowicie warta uwagi. Czym się charakteryzuje? Czy warto ją kupić? Jakie ma wady i zalety? Na te i inne pytania znajdziesz odpowiedź w tym wpisie. Zapraszam!HardwareNokia Lumia 900 jest najwyższym modelem od Finów. Moim skromnym zdaniem, to również najbardziej atrakcyjne urządzenie pracujące na Windows Phone 7, ale o tym za chwilę. "…

Windows Phone 7 w LG E900

Na wstępie dziękuje za zaproszenie na HotZlot. To było niesamowite przeżycie! Możliwość porozmawiania z ludźmi z redakcji i z czytelnikami dobrych programów, których znało się jedynie z xywek/avatarów - bezcenne :) Wpis nigdy by nie powstał, gdyby nie konkurs na Kinecta, gdzie udało mi się wywalczyć w boksie - LG z Windows Phone 7 :) Pozdro dla wszystkich uczestników konkursu :)Pierwsze kroki w Windows Phone 7Windows Phone 7 miałem okazje zobaczyć już w okolicach października/listopada 2010. W większości przeważały opinie, iż jest brzydki i mało intuicyjny. Wówczas po minucie spędzonej z nim, nie można było myśleć inaczej.Teraz mając go już dłużej, dochodzę do wniosku, iż jest on... na swój sposób piękny;) Po pierwszym uruchomieniu widzimy ekran główny z kafelkami. Zaskoczeniem jest, to iż nie ma znanego wszystkim pulpitu jak z Androida. Przypomina to raczej iOS. Tutaj jednak postawiono na przejrzystość i funkcjonalność.Na wstępnie dodam, iż telefon został zaktualizowany do najnowsz…

Windows Phone 7 - aplikacje na start

Czekając na premierę aktualizacji Mango do Windows Phone 7, która ma być wydana już na dniach, postanowiłem stworzyć wpis, opisujący aplikacje (darmowe) warte zainstalowania na swoim smartfonie.Jeśli nie wiesz co zainstalować "na dzień dobry" w Windows Phone 7, szukasz jakiś ciekawych aplikacji na swojego smartfona lub po prostu chcesz być na bieżąco z softem - ten wpis jest dla Ciebie! :) Smacznego ;)linki prowadzą do aplikacji Zune; jeśli nie ma linku to znaczy, że program nie był dostępny poprzez Zune, ale można go pobrać bezpośrednio z Marketplaceśrednia ocen i ilość recenzji dla każdego programu były brane z AppFlowMarketplace - wyszukiwarki (gorąco polecam!)AppFlow Ocena: 4,70/5 Recenzji: 230 Genialny program do wyszukiwania w Marketplace. To jest ta aplikacja od której warto zacząć przygodę z Windows Phone 7. Do wybory Top50 w następujących kategoriach:Top Indie Games- najlepsze gry niezależne,Top XBox Games - najlepsze gry na platformę Xbox na WP7,New & Impre…

Dysk SSD z Windows - konfiguracja

Wpis chcę zacząć od złożenia podziękowań na ręce Redakcji dobrychprogramów za wyróżnienie "bloger kwartału" i nagrodzenie dyskiem SSD (Kingston SSDNow V+100 96 GB - miodzio). Bardzo dziękuję za docenienie takiego szaraczka jak ja :) Mam nadzieję, że będę miał szansę się wyróżnić (i zasłużyć na wyróżnienie:P) oraz na to, aby zaskoczyć zarówno czytelników dobrychprogramów jak i Redakcję :)Kingston SSDNow V+100 96 GB - to nie jest recenzjaNie chce się powtarzać pisząc recenzję dysku SSD, którą zrobił już wcześniej Ave5 /pozdrawiam %) /. Różnica jest jedynie w większej pojemności.Ten wpis chciałbym poświecić konfiguracji dysku pod Windowsami. Ze względu na to, iż charakterystyka SSD wymusza pewnie działa, które dla dysku HDD nie miałyby sensu, a nawet powodowałyby spadek wydajności. Zanim jednak przejdę do optymalizacji...Krótko dodam kilka spostrzeżeń, odnośnie dysku SSD. Podczas zwykłem pracy, nie czuć przycięć i charakterystycznego dla dysków HDD, doczytywania danych, przy d…

Bazaar - alternatywny Windows Phone Marketplace z PC!

O Bazaar można było już usłyszeć. Jest to alternatywny Marketplace dla Windows Phone, który jest zbiorem aplikacji, których próżno szukać w Microsoftowym sklepie. W jednym miejscu otrzymujemy zbiór programów typu homebrew.Do tej pory był on dostępny jedynie poprzez aplikację instalowaną na odblokowane urządzenia z Windows Phone. Aby móc z niego ściągać na smartfona, należało mieć w pełni odblokowany system, wymagało to jednak przeinstalowania firmwareu na odpowiednio zmodyfikowany. Nie każdy chciał, ale i mógł to zrobić, gdyż jedynie kilka urządzeń doczekało się zmodyfikowanego systemu Windows Phone.Na szczęście ukazała się aplikacja desktopowa na Windowsa (do pobrania tutaj ), która pozwala na instalowanie aplikacji homebrew na urządzenia odblokowane już nawet developersko! Nic nie stoi na przeszkodzie, aby móc zapoznać się z alternatywnym Marketplace!Aby móc korzystać z Bazaar for PC potrzebujemy:odblokowany telefon (developersko+)Zune na PCzainstalowane Windows Phone SDKBazaar for…

Programistok - Białystok dla programistów i nie tylko

W Białymstoku powstała bardzo ciekawa inicjatywa promująca nowe technologie i trendy w programowaniu - Programistok. (Programistok na Facebooku: http://www.facebook.com/pages/Programistok/237808102923666 )Cykliczne spotkania będą omawiać m.in. programowanie na urządzenia mobilne, testowanie aplikacji, projektowanie interfejsów użytkownika czy pisanie lepszego, czystszego kodu. Każdy zainteresowany może zgłosić swoją propozycjię prezentację (20 - 30 minut).Impreza organizowana przy udziale firmy AmberBit (http://amberbit.com/ )Cele jakie przyświecają Programistokowi:integracja podlaskiego (i nie tylko) środowiska programistów poprzez wymianę pomysłów, doświadczeń wśród wielu różnych technologii związanych z internetem - nie ma narzędzi idealnych, każdy projekt warto rozpatrzyć indywidualniena spotkaniu są różnorodni ludzie, więc dobra okazja na poszukanie nowej pracy lub znalezienie pracownikaspotkanie raz w miesiącu w luźnej atmosferze (Pub Mao, Młynowa 44, http://www.mao.com.pl/ )…

Zdrowa praca przy komputerze cz. 2 - Urządzenia wspomagające

Postanowiłem dodać, króciutki wpis o pewnym małym urządzeniu, które zakupiłem kilka lat temu, pod wpływem artykułu w gazecie (niech mają! :P) CD-ACTION. Recenzent zachwycał się kuleczką, którą kręcił w dłoni. Uznałem to za kolejny zbędny gadżet, aż do momentu, gdy uświadomiłem, sobie, iż jestem w grupie podwyższonego ryzyka narażonego na zespół cieśni nadgarstka. Poza tym zbliżały się Święta i pomyślałem, że kupie sobie coś ciekawego (ile można dostawać skarpet i krawatów :P)Zespół cieśni nadgarstkaStan chorobowy tworzy się w wyniku długotrwałego nacisku na nerw pośrodkowy, biegnący w kanale nadgarstka. Powstaje ona często, gdy wykonujemy te same czynności ruchowe. W naszym przypadku na wskutek długotrwałego pisania na klawiaturze / używania myszki bez specjalnych podkładek.Objawy zespołu cieśni nadgarstka:osłabienie chwytuproblemy z zaciśnięciem ręki w pięśćmrowienie / bóle w nadgarstku / palcachosłabione czucie w palcachwypadanie trzymanych przedmiotów z rękiObjawy często pojawiają…