niedziela, 9 września 2012

WinJS na żywo - odc.5 (m.in search, własny binding)

Tym razem z poziomu WinJS dokonałem integracji z systemową wyszukiwarką, sprawiając tym samym osiągnięcie przez aplikację WinJS tej samej funkcjonalności, którą wcześniej zrealizowałem w C#. Oczywiście wiązały się z tym też mniejsze zadania…

Kontrakt Search oraz stronę z wynikami wyszukiwań najszybciej dodamy korzystając z Visual Studio 2012. Z menu kontekstowego w oknie Solution Explorer wybieramy Add New Item, a następnie szablon Search Contract. Dokumentacja opisuje wszystkie potrzebne czynności oraz co zostaje dodawane do projektu aplikacji po wybraniu szablonu. Chwilę może zająć analiza kodu wygenerowanej strony. Parę rzeczy zwróciło w praktyce moją uwagę. Code-behind strony z wynikami wyszukiwań jest zadeklarowany w default.html, zamiast w HTML tej strony. Jest to podyktowane tym, że:

  • obsłużenie zdarzenia aktywacji aplikacji przez wyszukiwarkę
  • rejestracja na wpisanie zapytania w wyszukiwarce

muszą odbywać się globalnie przy uruchomieniu aplikacji i nie zdecydowano się na modyfikację pliku z kodem globalnym. Konkretnie chodzi o kod:

WinJS.Application.addEventListener("activated", function (args) {
        if (args.detail.kind === appModel.Activation.ActivationKind.search) {
            args.setPromise(ui.processAll().then(function () {
                if (!nav.location) {
                    nav.history.current = { location: Application.navigator.home, initialState: {} };
                }                   

                return nav.navigate(searchPageURI, { queryText: args.detail.queryText });
            }));
        }
    });

appModel.Search.SearchPane.getForCurrentView().onquerysubmitted = function (args) { nav.navigate(searchPageURI, args); };

Jednocześnie HTML strony z wynikami wyszukiwania nie odwołuje się do pliku JavaScript o takiej samej nazwie, co powoduje, że strona w designerze Blenda nie prezentuje się w prawidłowy sposób. Jeśli jednak otworzymy default.html i w trybie interaktywnym przenawigujemy do strony z wynikami, to prezentuje się ona wtedy prawidłowo. Stylowanie jest wtedy przyjemnością….

W wygenerowanej stronie są przykładowe dane, które potrzebujemy z reguły zmienić. W moim przypadku potrzebuję filtrować pobrane pliki wideo, które są zapisywane w folderze lokalnym aplikacji. W definicji strony powstał w związku z tym następujący kod:

ready: function (element, options) {
            …

      this._handleQuery(element, options);

      …

},

_handleQuery: function (element, args) {

           …
           this._searchData(element, this._queryText);

           …
},

_searchData: function (element, queryText) {
            if (window.Data) {
                var folder = Windows.Storage.ApplicationData.current.localFolder;
                var queryOptions = new Windows.Storage.Search.QueryOptions(Windows.Storage.Search.CommonFileQuery.defaultQuery, [".mp4"]);
                queryOptions.folderDepth = Windows.Storage.Search.FolderDepth.deep;
                queryOptions.indexerOption = Windows.Storage.Search.IndexerOption.useIndexerWhenAvailable;

                if (queryText !== "")
                    queryOptions.userSearchFilter = queryText;

                var fileQuery = folder.createFileQueryWithOptions(queryOptions);

                var dataSourceOptions = {
                    mode: Windows.Storage.FileProperties.ThumbnailMode.picturesView,
                    requestedThumbnailSize: 95,
                    thumbnailOptions: Windows.Storage.FileProperties.ThumbnailOptions.useCurrentScale
                };

                var dataSource = new WinJS.UI.StorageDataSource(fileQuery, dataSourceOptions);

                var listView = element.querySelector(".resultslist").winControl;
                listView.itemDataSource = dataSource;
            }
        }

By cieszyć się widokiem:

jstube_11

dokonanałem jeszcze trochę zmian w kodzie i stylach strony. Na łamach krótkiego postu nie wydają się one aż tak istotne, by je omawiać, z wyjątkiem kolorowania wyszukiwanej frazy na elementach ListView.

Wygenerowana strona otrzymuje już taką funkcjonalność w postaci zdefiniowanej funkcji konwertera  _markText. W czym więc problem? Pułapka tkwi w klasie StorageDataSource. Jak już ostatnio w swoich postach pisałem, wymaga ona bindingów onetime. Jak zdefiniować w WinJS binding onetime, który korzysta z konwertera? Nie jest to tak oczywiste jak… w XAML-u. Sprawę zakończyło zdefiniowanie nowego bindingu zawierającego w sobie także logikę konwertera:

_bindMarkedText: function (source, sourceProperty, destination, destinationProperty) {
            var element = destination;
            var text = source && source[sourceProperty];
            if (!text) return;
            if (this._lastSearch)
                destination[destinationProperty] = text.replace(this._lastSearch, "<mark>" + this._lastSearch + "</mark>");
            else
                destination[destinationProperty] = text;
        },

Większa powszechność tworzenia własnych bindingów i ich większa otwartość jest typowa także dla innych bibliotek JS (np. Knockout’a). W ich logice oprócz konwersji mogą znajdować się także operacje na elementach wizualnych, w tym animacje. Wracając do naszego przypadku chciałbym zwrócić uwagę na funkcję WinJS.Binding.initializer, której użyłem do zadeklarowania, że funkcja _bindMarkedText może być stosowana w deklaratywnym data bindingu.

_handleQuery: function (element, args) {
            …
            WinJS.Namespace.define("searchVideos", { bindMarkedText: WinJS.Binding.initializer(this._bindMarkedText.bind(this)) });            
            …

        },

Teraz wystarczy dopilnować, by w HTML tekst w szablonie listy był zbindowany tak:

<div class="itemtemplate" data-win-control="WinJS.Binding.Template">
        <div class="item">

            …
            <div class="item-content">
                <h3 class="item-title win-type-x-small" data-win-bind="innerHTML: name searchVideos.bindMarkedText"></h3>               
            </div>
        </div>
    </div>

Na koniec zmieniłem sobie w CSS kolor zaznaczonego tekstu z domyślnego niebieskiego na pomarańczowy:

.searchVideos section[role=main] .resultslist .item .item-content mark {
                    background: transparent;
                    color: #D8512B;

     }

Do usłyszenia.

czwartek, 6 września 2012

WinJS na żywo - odc.4 (m.in Flyout, progress, stylowanie, binding, transfer w tle)

Tym razem padło na wizualizację dla pobieranych plików. Wzorowałem się na wcześniej powstałej wersji w C#, ale niektóre zagadnienia rozwiązałem inaczej i nieco przestylowałem wygląd… Jak zwykle Blend okazał się bardzo pomocny, a tryb interaktywny nieoceniony… Pewnej przebudowy wymagała też implementacja pobierania plików, tak że obecnie dostarcza listę bindowalnych obiektów z informacjami o transferach… Ale po kolei.

Jak zrobić coś ala-dropdownbutton w aplikacji Windows 8? Najbardziej odpowiednia wydaje się do tego kontrolka Flyout. W jej wnętrzu umieściłem pole tekstowe z nagłówkiem oraz ListView z layoutem listy. HTML wygląda następująco:

  <div id="statusFlyout" data-win-control="WinJS.UI.Flyout">
        <div>
            <div id="progressheader">
                <span>Downloading&nbsp;</span><span id="downloadscount">3</span><span>&nbsp;files</span>
            </div>           
            <div id="progresslist" data-win-control="WinJS.UI.ListView"
                data-win-options="{layout:{type:WinJS.UI.ListLayout}, selectionMode:'none', tapBehavior:'none'}">
            </div>
        </div>
    </div>  

Kontrolka Flyout wraz z zawartością nie jest domyślnie widoczna. Chcemy pokazywać ją pod przyciskiem statusButton wyświetlającym informacje o ilości pobieranych plików, który ma także powodować jej wyświetlenie. Do tego przycisku podpinamy więc handler:

function showStatusFlyout() {
        var statusButton = document.getElementById("statusButton");    
        document.getElementById("statusFlyout").winControl.show(statusButton, "bottom", "right");     
    }

W tym przypadku metodzie show przekazałem:

  • obiekt, do którego chcemy się doczepić (statusButton)
  • krawędź doczepienia (bottom)
  • wyrównanie (right - do prawej krawędzi statusButton)

Dotknięcie każdego punktu poza obszarem popup’a spowoduje jego zamknięcie.

ListView umieszczony we Flyout zachowuje się nieco inaczej. Jeśli ustawimy źródło danych na ListView, w momencie, gdy nie jest widoczne, to po otwarciu Flyout… lista będzie pusta. Podyktowane jest to pewną optymalizacją, która zaszła w wersji finalnej - niewidoczne kontrolki nie podlegają przetwarzaniu. Możemy jednak przed pokazaniem ListView wymusić przetworzenie jego layoutu:

var statusFlyout = element.querySelector("#statusFlyout");
            statusFlyout.addEventListener("beforeshow", function (event) {               
                var progresslist = element.querySelector("#progresslist").winControl;               
                progresslist.forceLayout();               
            });

Teraz trochę o stylowaniu.

jstube_9

HTML szablonu elementu listy wizualizującej transfery plików wygląda następująco:

<div class="progressitemtemplate" data-win-control="WinJS.Binding.Template">
        <div class="progressitem">          
            <h4 class="progressitem-title" data-win-bind="textContent: fileName"></h4>               
            <progress class="progressitem-progress" max="100" data-win-bind="value:progress"></progress>
            <div class="progressitem-details">               
                <span data-win-bind="textContent: bytesReceived"></span>
                <span class="text-part">of</span>
                <span class="text-part" data-win-bind="textContent: totalBytesToReceive"></span>
                <span class="text-part">KB</span>
            </div>
            <button class="progressitem-cancelbutton" type="button"></button>          
        </div>
    </div>

Nie sposób w tym dość krótkim poście przedstawić wszystkie szczegóły związane ze stylowaniem, zwrócę jedynie uwagę na pewne aspekty związane z ListView oraz na kontrolkę <progress>.

Aby ustawić przezroczyste tło na ListView, wyłączyć standardową wizualizację na najeżdżanie,  zrobić odpowiedni margines wystarczy:

#progresslist .win-container:not(.footprint):not(.hover)
{
    background-color: transparent;
}

#progresslist .win-container:hover {
    outline: transparent solid 0px;
}

#progresslist > .win-vertical .win-container {
    margin: 5px;
}

Przy okazji mała dygresja odnośnie animacji w WinJS. Jakby komuś przyszło do głowy wyłączyć standardowo wbudowane animacje w ListView, to okaże się, że przełącznika w CSS do tego… nie ma. Jest natomiast możliwość globalnego wyłączenia/włączenia efektów animacyjnych dla całej aplikacji (to trochę bardziej złożone zagadnienie, odsyłam do opisów metod WinJS.UI.enableAnimations() i WinJS.UI.disableAnimations() w MSDN). Tutaj nie wyłączałem animacji…

Kontrolka <progress> jest standardowa dla HTML5, tutaj ma domyślny wygląd w stylu Modern UI/Metro. Styl CSS dla niej przyjął u mnie ostatecznie postać:

#progresslist .progressitem .progressitem-progress {
    width: 100%;
    color: #D8512B;
    background-color: #3D3D3D;
    -ms-grid-row: 2;
    margin-top: 10px;
    margin-bottom: 10px;
    margin-left: 1px;
}

Co potrzebujemy jeszcze zrobić, by cieszyć się widokiem, takim jak poniżej?

jstube_10

Z pewnością potrzebujemy powiązać informacje o transferach z UI. Możemy w WinJS.Binding.List trzymać bindowalne obiekty, które możemy sobie budować na podstawie obiektów DownloadOperation:

function makeListEntryFromDownload(download, existing) {
       
        var entry = {};       
      
        entry.guid = download.guid;
        entry.fileName = download.resultFile.name.replace(".mp4","");
        entry.bytesReceived = download.progress.bytesReceived;
        entry.totalBytesToReceive = download.progress.totalBytesToReceive;
        entry.progress = (entry.bytesReceived / entry.totalBytesToReceive) * 100.0;
       
        if (existing) {
            entry.promise = download.attachAsync();
        }
        else {           
            entry.promise = download.startAsync();
        }

        entry.promise = entry.promise.then(
            function () {
                downloadComplete(entry, download);
            },
            function (e) {
                downloadError(entry, e);
            },
            function () {
                downloadProgress(entry, download);
            }
        );
       
        entry.cancelDownload = function (e) {
            entry.promise.cancel();
        }

        return (entry);
    }

Metoda WinJS.Binding.as(data) robi z podanego obiektu bindowalny obiekt. 

Przedstawiony wyżej kod wykorzystujemy dla obiektów DownloadOperation aktualnie zakolejkowanych transferów w serwisie w następujący sposób:

var entry = makeListEntryFromDownload(download, true);
bindingList.push(WinJS.Binding.as(entry));

BindingList to WinJS.Binding.List, którą możemy powiązać z ListView. W przypadku zlecenia nowego transferu napisaną przez nas metodą wywołujemy z parametrem false zamiast true.

Bindowalne obiekty możemy uaktualniać w następujący sposób:

function downloadProgress(entry, download) {
        var bound = WinJS.Binding.as(entry);
        bound.bytesReceived = download.progress.bytesReceived;
        bound.totalBytesToReceive = download.progress.totalBytesToReceive;
        bound.progress = (bound.bytesReceived / bound.totalBytesToReceive) * 100.0;
    }

Całość kodu zorganizowałem sobie podobnie jak w przykładzie Mike Taulty'ego, który ostatnio przypadł mi do gustu. Polecam zapoznać się z nim.

Przy okazji mała dygresja odnośnie transferu plików w tle. W trakcie rozwijania Windows 8, ostatecznie stanęło na tym, że transfery plików są kontynuowane przy uśpionej aplikacji. Jeśli proces aplikacji po jej uśpieniu zostanie zakończony, to przy ponownym uruchomieniu aplikacji, transfery plików są restartowane (zapamiętywana jest lista plików do transferu).

Stay tuned!

sobota, 1 września 2012

WinJS na żywo - odc. 3 (m.in pobieranie plików w tle, komponent WinRT, wyświetlanie miniatur plików w ListView, odtwarzanie video)

Przepisywanie z XAML i C# na HTML5 i WinJS nabrało tempa. Obecnie mogę pobierać pliki, przeglądać je i odtwarzać. Na tej drodze było parę niespodzianek, parę ciekawostek i na te tematy będzie dzisiejszy post.

Pewne zmiany nastąpiły przy przepisywaniu logiki wyciągania adresu ze strony YouTube z C# na JS (tak wiem, mogłem tego nie przepisywać, zrobić sobie komponent WinRT w C#, ale chciałem zobaczyć jak wyjdzie to całościowo w Java Script). O ile trzeba pamiętać, że niektóre tak samo nazywające się metody przy podaniu takich samych parametrów zadziałają inaczej (np. substring), o tyle kwestia unescapingu podanego napisu z linkiem okazała się trudniejsza. W WinJS mamy do tego metodę Windows.Foundation.Uri.unescapeComponent(toUnescape), w .NET mamy podobną metodę Uri.UnescapeDataString(stringToUnescape). Fragment strony HTML był z powodzeniem przetwarzany przez metodę w .NET, ale w Java Script już nie (zdaje się, że nie są to do końca odpowiedniki - JS ma jedną metodę do escape-owania spodziewającą się Uri, .NET ma dwie metody - jedną dla Uri i jedną dla stringa ze słowem DataString). Może mogłem przebudować algorytm tak by lepiej pasował do dostępnej funkcji w JavaScript, ale na tym etapie nie uznałem tego za celowe, więc … użyłem metody z C#. Jak? Opakowałem ją w komponent WinRT:

public sealed class EncodingUtils
    {
        public string UnescapeDataString(string stringToUnescape)
        {
            return Uri.UnescapeDataString(stringToUnescape);
        }
    }

i wykorzystuję w kodzie Java Script:

(function () {
    "use strict";   

var utils = new MyTubeUtils.EncodingUtils();

…

function getFormatUrl(buffer, format) {
      ….

     var str3 = utils.unescapeDataString(subStr);

      ….

}

})();

Przejdźmy teraz do pobierania plików w tle. Całkiem dobra implementacja zawarta jest w referencyjnym Background Transfer sample, przy czym tam zlecanie i wyświetlanie pobrań odbywa się w ramach jednej strony. U mnie zlecanie pobierania plików odbywa się z poziomu innej strony (Add New Videos) niż monitorowanie pobrań (Start), więc tę czynność musiałem sobie wydzielić:

function downloadFile(fileName, url) {

        var uri = new Windows.Foundation.Uri(url);

        Windows.Storage.ApplicationData.current.temporaryFolder.createFileAsync(fileName, Windows.Storage.CreationCollisionOption.replaceExisting).done(function (newFile) {
            var downloader = new Windows.Networking.BackgroundTransfer.BackgroundDownloader();
            var download = downloader.createDownload(uri, newFile);
            download.startAsync();
        });       
    }

Po otwarciu strony startowej zawsze sprawdzam, czy nie ma aktywnych pobrań plików i ustawiam w prawym górnym rogu odpowiedni status. Gdy plik zostanie z sukcesem pobrany przenoszę go z temporaryFolder do localFolder. Pojawia się nam teraz kolejne zagadnienie jak prezentować w ListView pobrane pliki video z miniaturami.

jstube_7

W C# używałem do tego klasy FileInformationFactory, która dla zdefiniowanego file query zwracała wirtualizowany wektor plików, który można było zbindować do ListView. Dzięki temu mieliśmy automatyczne odświeżanie listy, gdy nowy plik został pobrany (zapisany w localFolder). Jak to wygląda w WinJS? Okazuje się, że mamy podobne możliwości, ale nieco inne API.

Zacznijmy od zdefiniowania file query, którego definiowanie przypomina definiowanie w C#. W moim przypadku przedstawia się to następująco:

var folder = Windows.Storage.ApplicationData.current.localFolder;

var queryOptions = new Windows.Storage.Search.QueryOptions(Windows.Storage.Search.CommonFileQuery.defaultQuery, [".mp4"]);
queryOptions.folderDepth = Windows.Storage.Search.FolderDepth.deep;
queryOptions.indexerOption = Windows.Storage.Search.IndexerOption.useIndexerWhenAvailable;

var fileQuery = folder.createFileQueryWithOptions(queryOptions);

Musiałem dodać tutaj filtr na pliki o rozszerzeniu .mp4 (w takim formacie zapisuję na razie wszystkie pobierane pliki), ponieważ zauważyłem że aplikacja pisana w HTML5 tworzy sobie plik sesji w lokalnym folderze i … na początku trafił mi do ListView.

I teraz rzecz najciekawsza. W WinJS mamy specjalny storage typu StorageDataSource, który należy zbindować do ListView:

var dataSourceOptions = {              
                mode: Windows.Storage.FileProperties.ThumbnailMode.picturesView,
                requestedThumbnailSize: 283,
                thumbnailOptions: Windows.Storage.FileProperties.ThumbnailOptions.useCurrentScale
            };

var dataSource = new WinJS.UI.StorageDataSource(fileQuery, dataSourceOptions);

listView.itemDataSource = dataSource;

Dzięki temu mamy jak w C# automatyczne odświeżanie ListView, jeśli zapiszemy do localStorage nowy plik .mp4. Ze StorageDataSource wiąże się też parę faktów. Nie wspiera widoków grupowych oraz wymaga określonego rodzaju bindingów. Przy uruchamianiu aplikacji z dotychczas używanym szablonem dla elementu listy, otrzymałem wyjątek Cannot define property '_getObservable': object is not extensible. Trzeba zmienić domyślny rodzaj bindingu na onetime. Przykładowo, aby na szablonie elementu wyświetlić tytuł nagrania, robimy to tak:

<h4 class="item-title" data-win-bind="textContent: name WinJS.Binding.oneTime"></h4>

Jest też kwestia wyświetlenia obrazka na elemencie. W C# miałem do tego konwerter, który tworzył mi BitmapImage ze strumienia. W WinJS wyświetlenia obrazka również nie dostaniemy za darmo, trzeba napisać sobie własną funkcję do bindingu: 

(function () {
    "use strict";

…

function bindThumbnail(source, sourceProperty, destination, destinationProperty) {

    …
}

    WinJS.Utilities.markSupportedForProcessing(bindThumbnail);

    WinJS.Namespace.define("Start", {       
        bindThumbnail: bindThumbnail
    });
})();

Metoda WinJS.Utilities.markSupportedForProcessing służy do rejestracji naszej metody do deklaratywnego użycia (cześć bardziej standardowych metod np. dla strony, dla konwersji ma to zapewnione automatycznie)

Polecam tutaj skorzystać z implementacji bindThumbnail z referencyjnego StorageDataSource and GetVirtualizedFilesVector sample. Jak zobaczymy, oprócz konwersji obiektu pliku na URL i przypisania do do image.src autorzy wzbogacili ją o animacje w wybranych przypadkach. Przy okazji mała dygresja - pisanie bindingów własnego rodzaju za pomocą funkcji kojarzy mi się z Knockoutem.

Ostatecznie szablon elementu dla ListView wygląda następująco:

   <div class="itemtemplate" data-win-control="WinJS.Binding.Template">
        <div class="item">
            <img class="item-image" src="#" data-win-bind="src: thumbnail Start.bindThumbnail" style="opacity: 0;"/>
            <div class="item-overlay">
                <h4 class="item-title" data-win-bind="textContent: name WinJS.Binding.oneTime"></h4>               
            </div>
        </div>
    </div>

Teraz ostatnie na dziś główne zagadnienie - odtwarzanie plików video.

jstube_8

Aby po dotknięciu elementu ListView przejść na stronę, na której wyświetlimy wideo przydatny będzie zdefiniowanie funkcji _itemInvoked w funkcji definiującej stronę:

ui.Pages.define("/pages/start/start.html", {

….,

_itemInvoked: function (args) {
            args.detail.itemPromise.then(function (invokedItem) {
                nav.navigate("/pages/videoDetails/videoDetails.html", { video: invokedItem.data });
            }, false);                    
        }

Możemy teraz na stronie z wideo zamienić otrzymane dane na URL, który przekażemy elementowi <video> z HTML5.

WinJS.UI.Pages.define("/pages/videoDetails/videoDetails.html", {
       ready: function (element, options) {
            if (options && options.video) {
                var fileItem = options.video;
                var video = document.getElementById("player");
                video.src = URL.createObjectURL(fileItem);
                video.play();
            }           
        }
    });

Należy tu dodać, że dostajemy za darmo ładnie ostylowane UI z paskiem postępu, przyciskami i regulacją głośności (btw w przeglądarkach kontrolka <video> też oferuje podobne możliwości i jest otrzymuje predefiniowane UI, w aplikacji Windows 8 dostajemy styl Modern UI/Metro). Aby otrzymać wygląd kontrolki z przyciskami ze screenshota powyżej wystarczy wewnątrz strony użyć:

<video id="player" controls>                        
</video>

Oczywiście trochę trzeba było przestylować domyślny szablon strony, zmienić trochę CSS-ów, by kontrolka <video> zajmowała cały obszar strony i aby znajdowała się pod przyciskiem Back. Zastosowałem tutaj z-index by sekcja z nagłówkiem pojawiała się pod contentem strony z wideo. Aczkolwiek z nowym Blendem była to czysta przyjemność…

Jeszcze małe porównanie z XAML i C#. W wersji końcowej Windows 8 została wyrzucona kontrolka MediaPlayer, mamy do dyspozycji w jedynie MediaElement, który nie ma predefiniowanego UI do kontroli odtwarzania… W tym przypadku lepiej wygląda to w HTML5, ale piszący w C# mogą skorzystać z Player Framework for Windows 8, który oferuje gotową kontrolkę odtwarzacza oraz z przykładów.

Ciąg dalszy nastąpi.

wtorek, 28 sierpnia 2012

WinJS na żywo - odc.2 (m.in przestrzenie nazw, then/done, syndykacja)

W tym odcinku poruszę kilka zagadnień, które były przydatne przy realizacji wyszukiwania filmów na YouTube. 

Przy pisaniu większej ilości kodu, dobrze jest go sobie jakoś zorganizować. WinJS oferuje pomocnicze metody m.in do definiowania przestrzeni nazw i klas. Przy tak prostej funkcjonalności pobrania danych AtomPub i ich sparsowania z klas nie miałem potrzeby na razie korzystać, natomiast w odrębnych plikach w osobnych przestrzeniach nazw zawarłem sobie m.in logikę do komunikacji z YouTube. Definiowanie przestrzeni to w sumie nic innego jak stosowanie wzorca module. Przykładowo może to wyglądać następująco:

function searchVideos(queryText) {

}

WinJS.Namespace.define("YouTube", {
        searchVideos: searchVideos
});

Asynchroniczność jest domeną programowania w Windows 8. Interfejsy WinRT pod C# są widziane w postaci .NET-owego async, a jak jest w Java Scripcie?  Tutaj WinRT przyjmuje postać konstrukcji then/done, co jest znajome dla użytkowników jQuery oraz jest implementacją propozycji Common JS Promises/A. Najbardziej w tym wszystkim podoba mi się możliwość tworzenia łańcuchów z then. Czym się różni then od done? M.in tym, że then zwraca promise, done już undefined. Po done nie można już dalej ciągnąć łańcucha…

Na poniższym screenshocie funkcja searchVideos jest asynchroniczna, wywołuje w sobie asynchroniczną metodę retrieveFeedAsync z klienta syndykacji WinRT. Po jej poprawnym wykonaniu wykonuje się funkcja w then, która przetwarza otrzymany rezultat.

Mała dygresja - klient syndykacji wymaga obiektu Uri, przy przekazaniu samego stringa dostaniemy wyjątek.

jstube_5

Nie będę się rozpisywał na temat przetwarzania elementów syndykacji, odpowiednie przykłady można znaleźć choćby w MSDN. Powstało trochę kodu by wyłuskać odpowiednie potrzebne informacje. W C# stosowałem często znaną z Linq extension metodę FirstOrDefault z podaniem warunku. W gołym JS w standardzie ECMA Script 5 mamy trochę metod pomocniczych do tablic, ale dokładnie czegoś takiego nie odnalazłem. Posiłkowałem się tutaj metodą find z biblioteki Underscore, co zaowocowało przykładowo taką linijką kodu:

var group = _.find(item.elementExtensions, function (node) {
                return node.nodeName === "group" && node.nodeNamespace === mediaNamespace;
            });

Biblioteka jest prosta w użyciu, działają podpowiedzi IntelliSense, można ją zdecydowanie polecić.

Kolejnym zagadnieniem okazała się obsługa pola tekstowego. Chciałem by podobnie jak w C# wyszukiwanie uruchamiało się przy zmianie tekstu z pewnym opóźnieniem czasowym przy wpisywaniu liter. Input tekstowy ma zdarzenie “change”, ale wyzwalane jest ono dopiero po utracie focusa przez kontrolkę. Nowe przeglądarki (a także engine JS natywnej aplikacji wspólny z IE10) obsługują też zdarzenie “input”, które jest wyzwalane przy każdej zmianie tekstu bez potrzeby opuszczania kontrolki. Dodatkowo dodałem tutaj timer. Całościowo przybrało to taką postać:

var searchInput = document.getElementById("search");
            var timer = null;
            searchInput.addEventListener("input", function () {
                if (timer === null) {
                    timer = setTimeout(function () {
                        timer = null;

                        YouTube.searchVideos(searchInput.value).then(function (data) {
                            listView.itemDataSource = null;
                            var list = new WinJS.Binding.List(data);
                            listView.itemDataSource = list.dataSource;
                        });

                    }, 500);
                }                             
            });

Przy okazji mała dygresja - do zmiany elementów w kontrolce ListView potrzebny jest pokazany kod. Samo przypisanie nowej listy nie odświeża. Możemy już cieszyć się ekranem przedstawionym poniżej:

jstube_6

Na koniec obsłużmy przycisk ze “strzałką w dół”. W tym miejscu chcemy przekazać dane z zaznaczonych elementów ListView do metody rozpoczynającej pobieranie i powrócić do strony startowej. Możemy zrealizować to w następujący sposób:

document.getElementById("cmdDownload").addEventListener("click", function () {
                listView.selection.getItems().done(function (items) {
                    var dataArray = _.map(items, function (item) { return item.data; });
                    Download.startDownload(dataArray);
                });               
                WinJS.Navigation.navigate("/pages/start/start.html");
            });

Na dziś koniec. Stay tuned…

niedziela, 26 sierpnia 2012

WinJS na żywo - odc. 1 (Wstęp & Blend)

Po napisaniu prototypu aplikacji pobierającej clipy z YouTube w C# na Windows 8 (a także ostatnio na WP*), postanowiłem przepisać to co już powstało na WinJS w Windows 8. Przeglądałem jakiś czas temu niemal całą dokumentację msdn na ten temat, ale myślę, że jednak najlepiej pobawić się w praktyce. W międzyczasie przyswoiłem pewną ilość wiedzy na temat samego HTML5, JavaScript, CSS3, jQuery, Knockout oraz innych nowych standardów i frameworków dla aplikacji Web, więc teraz to spojrzenie na WinJS będzie myślę bardziej dojrzałe. Jako, że zawsze bardzo lubiłem narzędzie Blend, więc również i tym razem będę go używał.

Trzecią część tryptyku rozpocząłem od stworzenia nowego projektu z dwiema stronami z przykładowymi danymi, z których drugą przedstawiam poniżej:

jstube_1

Zaraz, zaraz czy takiego screenshota już tutaj nie było? Owszem, jak ktoś przepatrzy historię, to może znaleźć nawet taki z tymi samymi zdjęciami (gdy używałem na początku w C# przykładowych danych, były takie same).

mks_01_C 

Aplikacje w C# i w HTML5 na WinRT nie różnią się wizualnie ani zachowaniem, co świadczy o sporym postępie jeśli chodzi o wykorzystanie technologii Web do pisania natywnych aplikacji.

Teraz parę słów o Blendzie. Nie będę pisał kolejnego tutoriala, jak obsługiwać w nim HTML, JS i CSS, można znaleźć to wszystko w sieci. Ze swojej strony mogę powiedzieć, że jeśli ktoś zna Blenda pod XAML, to tutaj trzeba… chwilki czasu, by się oswoić. Twórcy postanowili odzwierciedlić HTML i CSS takimi jakimi są, bez upiększeń, nie mamy w zasadzie żadnej abstrakcji. Na początku może nam brakować pewnych paneli aplikacji jakie znamy z XAML, ale w miarę używania poczujemy bardzo dużą wygodę korzystania mimo odmiennej filozofii działania. Bardzo wiele rzeczy można zrobić z poziomu designera czy wykorzystując inne pomocnicze narzędzia. W pewnej mierze jest to wzorowane na narzędziach z przeglądarek webowych czy narzędziach dla aplikacji Web w Visual Studio 2012, ale część mechanizmów znanych z Blenda dla XAML zostało tutaj osadzonych.

Zwrócę teraz uwagę na kilka wybranych rzeczy. Layout odpowiadający Grid-owi z XAML, możemy robić … tak samo. Jest to zasługą specyfikacji Grid Layout w CSS3 (szkoda że przy “otwartych” aplikacjach webowych to zagadnienie jest bardziej złożone z uwagi, że na razie chyba jedynie IE10 implementuje ten standard). Na razie używałem grid i flex w paru miejscach… Na screenshocie grid w AppBar z niestandardową zawartością… (btw AppBar pod WinJS jest na większym poziomie organizacyjnym, ma też wygodniejszą obsługę z poziomu Blenda).

jstube_2

Warto powiedzieć, że w designerze wykonuje się kod JS na żywo, z reguły do obserwowania zmian automatyczne odświeżanie jest wystarczające. Z dużą łatwością ustalimy, dlaczego np. dany element ma taki kolor a nie inny. Widzimy jakie reguły CSS z jakich plików odnoszą się do danego elementu, która reguła zwyciężyła, jakie wartości są ostatecznie wyliczane.

jstube_3

Przy okazji mała dygresja na temat gwiazdek. W C# użyłem dla celów demonstracyjnych jedynie napisu, w WinJS mamy kontrolkę Rating, której parametr pozwoliłem sobie zbindować. Trochę też ją przestylowałem, pomniejszając nieco gwiazdki i zmieniając im kolor… Miałem tutaj chwilkę na wyczajenie jednego parametru z layoutu flex. Kontrolka mi się niepotrzebnie rozciągała horyzontalnie, nawet wbrew innym ustawieniom. Pomogło ustawienie w stylu dla gwiazdki ms-flex: 0 0 auto …

Koniecznie należy wspomnieć o przycisku ze “strzałką z kreseczkami” nad prawą górną krawędzią designera. Otwiera nam okno trybu interaktywnego, w którym możemy coś zrobić w naszej aplikacji, a potem wrócić z powrotem wrócić do designera. Mi się to bardzo przydało, gdy edytowałem wygląd zaznaczonego elementu.

jstube_4

W przeciwieństwie do kontrolki z C# zamiast docelowego wyglądu, jaki chciałem osiągnąć w WinJS zastałem domyślnie niewidoczne obramowanie oraz check z przezroczystym tłem przy domyślnej zmianie tła całego elementu na niebieski. Taki styl spotkamy w części wbudowanych aplikacji np. Skydrive. Wszędzie tam stawia się na mały obrazek, jakiś napis i przezroczyste tło, które zmieni kolor. Mi jednak bardziej pasowało by to obrazek był tłem, chciałem więc mieć wygląd taki jaki jest domyślny w C# i … trochę mi to zajęło. Ponieważ nie jest to takie oczywiste więc podam sposób, w jaki osiągnąłem pomarańczową ramką i check w pomarańczowym trójkącie.

Pomarańczowa ramka: ramka … już jest, wystarczy zmienić tylko jej kolor definiując regułę nadpisującą (u mnie były takie zagnieżdżenia jak poniżej, w każdym razie należy zwrócić uwagę na zagnieżdżenie klas .win-selected .win-selectionborder w kontrolce ListView):

.addnewvideospage .groupeditemslist .win-selected .win-selectionborder {
                background-color: #D8512B;   
            }

Z pomarańczowym trójkątem było już gorzej, bo po zmianie koloru tła elementu z checkiem w kontrolce okazał się … prostokątem. Posiłkując się stronami w sieci na temat otrzymywania figur z bordera (np. http://css3shapes.com/, http://www.howtocreate.co.uk/tutorials/css/slopes), ustawiłem regułę:

.addnewvideospage .groupeditemslist .win-selected .win-selectioncheckmarkbackground {
                width: 0px;
                border-top: 20px solid #D8512B;
                border-right: 20px solid #D8512B;
            }

Teraz mała dygresja o tym, jak zrobiłem formatowanie daty. W XAML był to konwerter do bindingu (w przeciwieństwie do Silverlight nie ma StringFormat), w WinJS też mamy podobną koncepcję. Definiujemy funkcję w JavaScript:

var formatDate = WinJS.Binding.converter(function (date) {       
        var dateTimeFmt = new Windows.Globalization.DateTimeFormatting.DateTimeFormatter("{day.integer(2)}/{month.integer(2)}/{year.full}‎ {hour.integer(2)}: {minute.integer(2)}");
        return dateTimeFmt.format(date);
    });

Rejestrujemy ją w przestrzeni nazw (w sumie jest to jakaś implementacja w WinJS jednego z polecanych wzorców projektowych dla JS):

WinJS.Namespace.define("Data", {
        formatDate: formatDate, …
});  

W data bindingu po ścieżce dopisujemy zdefiniowaną funkcję konwertującą:

<h6 class="item-subtitle" data-win-bind="textContent:pubDate Data.formatDate"></h6>

Inną małą dygresją jest wyświetlanie automatyczne wyświetlanie … w przypadku, gdy napis okaże się za długi. W XAML czy Silverlight był na to parametr w TextBlock, w HTML na Windows 8 wystarczy użyć predefiniowanej klasy win-type-ellipsis np.

<h4 class="item-title win-type-ellipsis" data-win-bind="textContent: title"></h4>

W sumie to nasunął mi się jeden komentarz odnośnie data bindingu w WinJS po tych dwóch dygresjach. Używa data-* więc jest zgodny z HTML5 i przypomina Knockouta.

Wiadomo, nie opiszę wszystkiego-;)  Myślę że jak na ten post to już wystarczy.

Ciąg dalszy nastąpi.

wtorek, 21 sierpnia 2012

Windows 8 na Slate - krótka relacja

Tematyka uruchamiania i debugowania aplikacji Windows 8 na zdalnym urządzeniu nie jest nowa. Niemniej jednak postanowiłem zrobić małe podsumowanie na ten temat przy okazji ukazania się finalnej wersji Windows 8.

By cieszyć się aplikacją uruchomioną na slacie musimy najpierw zainstalować na nim Windows 8. Proces zasadniczo nie różni się od PC, z tym że tutaj nie mamy napędu DVD i potrzebujemy zrobić sobie bootowalne USB. Ostatnio z powodzeniem wykorzystałem opis potrzebnych czynności ze strony How to Create Windows 8 Bootable USB Device from ISO Image using WinUSB Maker. Mając  bootowalne USB, ustawiamy w BIOS-ie kolejność bootowania, tak by pierwszym urządzeniem był nasz pendrive (przez USB podłączamy wcześniej klawiaturę). Minimalna rozdzielczość dla aplikacji Metro w Windows 8 to 1024 x 768. Jeśli ktoś ma starszy sprzęt, który obsługuje maksymalnie 1024 x 600, to pomóc może edycja rejestru. Ten sposób zadziałał mi także dla finalnej wersji Windows. Oczywiście lepiej jest mieć nowe urządzenie stworzone specjalnie dla Windows 8 (np. Microsoft Surface).

Aby debugować zdalnie na tablecie aplikacje Metro, wystarczy zainstalować na nim Remote Tools for Visual Studio 2012 (w zależności od środowiska na tablecie wybieramy wersję x86, x64 lub ARM, w moim przypadku było to x64). W dalszej kolejności potrzebujemy:

  • wygenerować deweloperską licencję dla tableta - w tym celu wpisujemy w jego konsoli PowerShell polecenie Show-WindowsDeveloperLicenseRegistration (dostajemy wtedy okno generowania licencji  znane zapewne już wszystkim z Visual Studio 2012)
  • uruchomić na tablecie Remote Debugging Monitor (aplikacja z ikoną trójkąta po instalacji Remote Tools)

Nasz tablet jest już w zasadzie gotowy. Teraz jedynie powinien … być widoczny dla maszyny, na której budujemy aplikacje. Komunikacja między nimi może odbywać się za pomocą sieci Ethernet w Intranecie lub poprzez bezpośrednie połączenie ich kablem Ethernet, przy użyciu adapterów dla USB przy braku gniazda Ethernet w urządzeniu mobilnym. W moim przypadku komputer z Visual Studio i slate’a umieściłem w tej samej sieci lokalnej, slate komunikował się bezprzewodowo za pomocą Wi-Fi. Na maszynie deweloperskiej wystarczy teraz w Visual Studio wybrać debugowanie na zdalnej maszynie. Pojawia się okno, w którym możemy ręcznie skonfigurować połączenie lub po prostu wybrać jedno z wykrytych urządzeń. W moim przypadku wyglądało to tak:

win8_rem1

Możemy już teraz zdalnie debugować aplikację na tablecie (wgrywana jest tam automatycznie)

WP_000037 WP_000052

Więcej informacji na powyższe tematy możemy znaleźć na MSDN:

niedziela, 19 sierpnia 2012

Windows 8 RTM & Visual Studio 2012 RTM - pierwsze wrażenia

W ostatnich dniach ukazały się Windows 8 w wersji finalnej dla deweloperów (kompilacja 9200) oraz finalne Visual Studio 2012 (wraz z finalnym .NET 4.5). Dziś parę zdań na ich temat.

Linki do pobrania wszystkiego (systemu i wszystkich narzędzi) zostały umieszczone na stronie Downloads for Metro style app development. Jeśli chodzi o podstawowe narzędzia, czyli Visual Studio 2012 z Blendem, to oprócz domyślnej wersji Visual Studio Express 2012 for Windows 8, można też korzystać z jednej z wersji Visual Studio 2012.

win8_rtm

Jeśli chodzi o sam Windows, to w stosunku do wcześniejszych wersji mamy inną domyślną kolorystykę, znacznie ładniejsze tapety na pulpit i na lock screen (nie widziałem tego rysunku już gdzieś na jakiejś konferencji MS?) oraz możliwość konfigurowania tapet i kolorystyki ekranu startowego. W aplikacjach też można zauważyć różne zmiany w designie i w funkcjonalnościach…

image

Jeśli chodzi o Visual Studio 2012, to można zauważyć, że zgodnie z ostatnią polityką odchodzenia od terminu Metro, projekty aplikacji dla Windows 8 znajdują się obecnie pod kategorią “Windows Store”. Inną ciekawostką jest nie działający jeszcze link do doinstalowania Windows Phone 8 SDK pod kategorią Windows Phone. Blend for Visual Studio 2012 zawiera jedynie projekty dla Windows 8.

Jeśli chodzi o migrację aplikacji z wersji Release Preview na RTM, to są to niewielkie zmiany. Całość opisuje Migration guide. Najwięcej stosunkowo zmian zaszło w API pod C++ i JS. Ja swoją aplikację w .NET już zmigrowałem, działa!