Kontrola režimu náhledu v Xamarin.Forms

Visual Studio pro Windows a Mac nyní obsahuje Xamarin XAML Previewer, který nám umožňuje zobrazit náhled vašich Xamarin.Forms XAML souborů bez nutnosti spuštění aplikace. Bohužel v některých případech může obsahovat konstruktor vašich stránek kód, se kterým si Previewer nedokáže poradit (například service resolution, apod.) a spadne. Můžeme snadno ověřit zda aplikace běží v režimu náhledu (design mode)?

XAML Previewer
XAML Previewer

Pokračovat ve čtení “Kontrola režimu náhledu v Xamarin.Forms”

Výběr formátu správy NuGet balíčků pro nové projekty

Nové Visual Studio 2017 přichází s podporou pro nový formát správy NuGet balíčků – PackageReference, který nahrazuje staré formáty Packages.config a project.json a přidává odkazy na balíčky přímo do projektového souboru. Tento formát by měl být do budoucna pro NuGet standardem (nebo-li, slovy NuGet týmu “the one NuGet standard to rule them all” 🙂 ), ale není podporován ve starších verzích Visual Studia. Podle vašho konkrétního scénáře můžete chtít zvolit vhodný formát správy balíčku přesně podle typu projektu, na kterém pracujete. Naštěstí Visual Studio právě tuto možnost nabízí pomocí nového nastavení. Pokračovat ve čtení “Výběr formátu správy NuGet balíčků pro nové projekty”

Použití vlastního nuget.exe v konfiguraci buildu na VSTS

Krátce po vydání Visual Studia 2017 přidal tým Visual Studio Team Service nový hostovaný build agent Hosted VS2017 který zahrnuje podporu pro všechny nejnovější verze vývojářských nástrojů Microsoftu. Bohužel, přestožee build task pro Visual Studio build novou verzi 2017 podporuje, nejnovější verze NuGetu ještě přidána nebyla. Naštěstí je ale možné při buildu použít vlastní nuget.exe a použít jej pro restore balíčků projetku, který používá nové <PackageReference> v projektovém souboru csproj. Pokračovat ve čtení “Použití vlastního nuget.exe v konfiguraci buildu na VSTS”

Jak vynutit otevření CommandBaru směrem dolů

Ovládací prvek CommandBar  je důležitou komponentou pro design UWP aplikací. Jde o evoluci konceptu   AppBar , který je dostupný již od dob Windows Phone 7, ale v případě UWP má výrazně více funkcí. Stále však chybí možnost určit směr, kterým se command bar bude otevírat.

Problém

Výchozí chování CommandBaru je otevření směrem nahoru vždy, kdy není na samotném horním okraji okna. To je problém, protože toto platí i v případě, že definujeme vlastní title bar aplikace na Desktopu, kdy se   CommandBar  otevře pod tlačítka minimalizace, maximalizace a zavření okna a to rozhodně nevypadá dobře.

Výchozí šablona

Výchozí šablona prvku CommandBar  definuje kolekce VisualState  a  VisualStateTransition , které určují, jak bude prvek vypadat. Můžeme si všimnout že je vždy separátně definován stav pro otevření směrem dolů a nahoru.

Uvnitř těchto stavů můžeme vidět, že systém jen používá různé hodnoty pro některé z vlastností jako například CommandBarTemplateSettings.ContentHeight  resp. CommandBarTemplateSettings.NegativeOverflowContentHeight  pro vlastnost  Y  u transformace OverflowContentRootTransform .

Řešení

Nemůžeme snadno modifikovat vnitřní logiku ovladacího prvku, ale můžeme zajistit, že bude vypadat pro stav otevření nahoru identicky jako pro otevření dolů. Toho můžeme dosáhnout čistě překopírováním Storyboardů  ze stavů a přechodů se obsahujících ...OpenDown do jim odpovídajících  ...OpenUp  protějšků. Bohužel manuální překopírování je jediná možnost. Bylo by sice také možné jednotlivé Storyboardy  převést na samostatné resource, ale bohužel je pro VisualState  a VisualStateTransition nelze referencovat pomocí syntaxe {StaticResource}.

Pro získání kompletní kopie výchozího stylu olvadacího prvku můžeme buď použít Visual Studio XAML Designer (klepněte na prvek pravým tlačítkem myši, vyberte Edit Template a Edit a Copy…), nebo ji lze vyhledat na v souboru   C:\Program Files (x86)\Windows Kits\10\DesignTime\CommonConfiguration\Neutral\UAP{version}\Generic\generic.xaml

Abych vám ušetřil klávesy  Ctrl , C  a V , připravil jsem kompletní upravený styl, který můžete přímo použít ve vaší aplikaci. Styl je ke stažení na mém GitHubu spolu s ukázkovým projektem k tomuto článku. Upozorňuji, že můj definovaný styl je pro verzi Anniversary Update. Pro budoucí verze doporučuji změny provést manuálně na aktuální šabloně.

Shrnutí

CommandBar  je skvělý ovladací prvek, který většinou funguje přesně tak, jak potřebujeme. Když však narazíme na problém, můžeme jeho šablonu poměrně snadno modifikovat.

Jak přidat nová zařízení pro náhled v XAML designeru

Visual Studio XAML Designer pro Univerzální platformu Windows nabízí výběr zařízení pro náhled pro různé kombinace rozlišení a škálování. Bohužel, výchozí seznam nemusí být dostačující, obzvláště pokud chcete optimalizovat pro nějaké konkrétní zařízení, které na něm nefiguruje. Je možné nabídku rozšířit na více zařízení?

Výchozí seznam zařízení ve Visual Studio XAML Designeru

Pokračovat ve čtení “Jak přidat nová zařízení pro náhled v XAML designeru”

Zarovnání obsahu UWP CommandBaru po Anniversary Update

Ovladací prvek CommandBar získal s Anniversary Updatem novou funkci dynamic overflow, která automaticky upravuje počet zobrazených tlačítek tak, aby se vešly na obrazovku a zbylá tlačítka nechá “přetéct” do sekundárního menu. Tato novinka bohužel přinesla neúmyslné problémy některým vývojářům, kteří používali vlastnost Content pro zobrazení dalšího obsahu na panelu – zarovnání obsahu nyní nefunguje dle očekávání.

Problém

Situaci demonstrujeme na jednoduchém příkladě:

Očekáváme, že obsah panelu bude zarovnaný uprostřed volného místa, které zbývá po umístění tlačítek. A tak tomu také před Anniversary Update bylo.

Od verze 14393 SDK ale vlastnost  HorizontalContentAlignment  ve výchozím stavu není respektována a obsah je zarovnán vlevo.

CommandBar ve výchozím stavu nerespektuje vlastnost HorizontalContentAlignment

Příčina problému

Výchozí šablony ovladacích prvků jsou definovány v souboru XAML resource dictionary na následující cestě: C:\Program Files (x86)\Windows Kits\10\DesignTime\CommonConfiguration\Neutral\UAP\10.0.14393.0\Generic\generic.xaml . Pokud v tomto souboru vyhledáte šablonu pro CommandBar  , zjistíte, že obsahuje novou skupinu  VisualStateGroup :

Jak je z kódu vidět, při povoleném dynamic overflow se mění nastavení velikosti sloupců v rozložení CommandBaru .

Ve výchozím visual state ( DynamicOverflowDisabled ) je   ContentControlColumnDefinition.Width  nastavena na  *  (hvězda) a PrimaryItemsControlColumnDefinition.Width  nastavena na  Auto . To znamená, že tlačítka napravo zabírají určitou šířku a zbylý prostor je dedikován obsahu Content .

Když je dynamic overflow povolen, velikosti sloupců se prohodí. Ovladací prvek nyní nechá sloupec s tlačítky roztáhnout (aby dostupné místo mohl potenciálně využít pro více tlačítek a mohl také spočítat prostor pro ně za běhu aplikace) a sloupec s obsahem dostane už pouze takový prostor, který skutečně potřebuje. To znamená, že s povoleným dynamic overflow bude obsah vždy vypadat jako zarovnaný vlevo, protože jeho sloupec mu nenabízí žádné místo navíc.

Od Anniversary Update je dynamic overflow u command baru ve výchozím stavu povolen.

Řešení

Dynamic overflow můžete vypnout pomocí vlastnosti IsDynamicOverflowEnabled. Ačkoliv se poté musíte ujistit, že se tlačítka na panelu zobrazují správně pro všechna rozlišení obrazovky, můžete díky tomu zarovnávat obsah dle potřeby.

Zakázání dynamic overflow opraví problém se zarovnáním obsahu

Pokud chcete zachovat dynamic overflow, můžete namísto jeho vypnutí okolo vašeho obsahu přidat odsazení ( Margin ) tak, aby vypadal zarovnaný. Pravděpodobně bude ale nutné použít Adaptive Triggery aby odsazení vypadalo dobře na každém zařízení.

Použití vlastních fontů v C# UWP aplikacích

Přestože výchozí Windows 10 font Segoe UI je rozhodně velmi pěkný, čas od času můžete chtít vaší aplikaci vdechnout punc originality pomocí jiného fontu.

V UWP aplikacích můžete použít téměř kterýkoliv .ttf .otf font. .woff a .eot fonty nyní nejsou v C# UWP aplikacích podporovány (ale lze je použít v JavaScriptových UWP aplikacích).

Získání fontu

Nejprve si samozřejmě musíte nějaký font vybrat. Na internetu je k dispozici mnoho fontů, které lze použít zdarma (i v komerčních projektech), a také mnoho fontů, které si můžete zakoupit.

Google Fonts a Font Squirrel jsou skvělé zdroje nepřeberného množství fontů zcela zdarma.

Poté co si vyberete font, který se vám líbí, stáhněte si jeho .ttf nebo .otf soubor a přidejte jej do vašeho UWP projektu jako Content (Build Action v property manageru).

Ujistěte se, že je font přidán s Content Build Action
Ujistěte se, že je font přidán s Content Build Action

Nastavení fontu v XAMLu

Každý textový ovladací prvek v XAMLu má vlastnost FontFamily, pomocí které lze font nastavit. V případě předinstalovaných fontů stačí zadat jejich název. V případě vlastních fontů musíme být více specifičtí:

[CestaKFontu] je relativní cesta k souboru s fontem v projektu. V případě, že máte ve složce Assets/Fonts font ArimaMadurai-Black.ttf, použijte /Assets/Fonts/ArimaMadurai-Black.ttf jako cestu.

[JmenoFontu] je jméno fontu. Zde je však malý háček. Některé fonty vyžadují, aby jméno fontu zahrnovalo i jeho konkrétní typ (tloušťka či italika fontu), v jiných případech stačí jméno samotné. Použitím metody pokus omyl můžete zjistit, která forma je požadována. XAML designer by měl změnu okamžitě reflektovat.

Použití okna Properties

Výběr fontu v okně properties

Namísto manuálního nastavení fontu v XAMLu můžete použít okno Properites ve Visual Studiu. Vyberte si v kódu nebo v designeru nějaký ovladací prvek a následně rozbalte sekci Text v Property manageru. Pomocí rozbalovacího seznamu Font si můžete vybrate nejen z fontů, které jsou na vašem zařízení nainstalovány, ale i z vlastních fontů, které jste přidali do projektu (tyto by se měly zobrazovat na začátku seznamu).
Upozornění: okno Properties vždy přidá na konec jména fontu i jeho typ. Pokud se font nezobrazuje správně, zkuste typ fontu z konce hodnoty vlastnosti FontFamily odebrat ručně.

Nastavení fontu v kódu

Změna fontu v kódu vyžduje pouze vytvoření instance třídy Windows.UI.Xaml.Media.FontFamily a předání stejné řetězcové hodnoty, kteoru jsme používali v XAMLu, jejímu konstruktoru.

DirectWrite downloadable fonty

Windows 10 přidal novou funkci XAML integration of DirectWrite downloadable fonts. Díky ní můžete nastavit font některého XAML ovladacího prvku na dosud nenainstalovaný font a DirectWrite jej automaticky stáhne na pozadí. Než se font stáhne, text bude zobrazen pomocí výchozího fontu. Navíc by měla funkce inteligentně stahovat pouze ty části fontu, které skutečně potřebujete, což je velká výhoda u velkých znakových sad, jako je Japonština, Čínština nebo Korejština. Stažené fonty jsou uloženy v systémové cache, aby mohly být znovu použity a to i jinou aplikací.

Tato novinka vypadá velmi užitečně, ale bohužel zatím není vůbec dokumentováná. Jediný zdroj pro ni je nyní ukázkový projekt XamlCloudFontIntegration v repozitáři Windows Universal Samples na Githubu. Tento projekt obsahuje tři fonty, které DirectWrite dokáže stáhnout a také PowerShell skript, který porčistí systémovou cache pro fonty.

Ukázkový kód pro tento článek si můžete prohlédnout a stáhnout na mém GitHubu.