XAML in Xamarin.Forms 基礎篇 電子書
XAML in Xamarin.Forms 基礎篇 電子書
Xamarin.Forms 快速入門 電子書
Xamarin.Forms 快速入門 電子書
2019/04/08
Xamarin.Forms 的檢視 View 與版面配置 Layout 的手勢 Gesture 操作
Xamarin.Forms 的檢視 View 與版面配置 Layout 的手勢 Gesture 操作
就在上週， Visual Studio 2019 正式發表了，隨之而來的驚奇工作那就是要來體驗 Visual Studio 2019 這套新的開發工具所帶來的絕佳操作感覺，也就是說，在 2019年四月之後，我這裡所寫關於 Xamarin.Forms 的範例程式碼，將會全部改成使用 Xamarin.Forms 來設計。在這篇文章中，將會來測試 Xamarin.Forms 的手勢操作的設計上的問題，那就是可以在使用者控制項與版面配置上來使用 GestureRecognizers 屬性來指定其需要執行相對應手勢操作需要進行的綁定命令。可是，當在一個 Layout 上有指定 GestureRecognizers ，並且放置一個使用者控制項到這個版面配置上，此時，該使用者控制項若有指定 GestureRecognizers ，那麼，是版面配置的 GestureRecognizers 會被觸發，還是使用者控制項的 GestureRecognizers 會被觸發呢？
因此，在我心中存在者許多疑問，便想要寫可個範例程式碼來逐一檢測底下的問題？
- 當在一個 Layout 上有指定 GestureRecognizers ，並且放置一個使用者控制項到這個版面配置上(該使用者控制項並未完全佔用滿整個版面配置空間)，此時，該使用者控制項若有指定 GestureRecognizers ，那麼，當使用者點選該使用者控制項的時候，是哪個 GestureRecognizers 會被觸發呢？
- 當在一個 Layout 上有指定 GestureRecognizers ，並且放置一個使用者控制項到這個版面配置上(該使用者控制項並未完全佔用滿整個版面配置空間)，此時，該使用者控制項若沒有指定 GestureRecognizers ，那麼，當使用者點選該使用者控制項的時候，是哪個 GestureRecognizers 會被觸發呢？
- 當在一個 Layout 上有指定 GestureRecognizers ，並且放置一個按鈕到這個版面配置上(該使用者控制項並未完全佔用滿整個版面配置空間)，此時，該按鈕若有指定 Command ，那麼，當使用者點選該按鈕的時候，是否會觸發 Layout 的GestureRecognizers呢？
- 當在一個 Layout 上有指定 GestureRecognizers ，並且放置一個按鈕到這個版面配置上(該使用者控制項並未完全佔用滿整個版面配置空間)，此時，該按鈕若沒有指定 Command ，那麼，當使用者點選該按鈕的時候，是否會觸發 Layout 的GestureRecognizers呢？
- 當在一個 Layout 上有指定 GestureRecognizers ，並且放置一個文字輸入盒到這個版面配置上(該使用者控制項並未完全佔用滿整個版面配置空間)，此時，若點選該文字輸入盒，是否會觸發 Layout 的GestureRecognizers呢？
為了要能夠了解這些疑問，所以，請依照底下步驟建立一個 Xamarin.Forms 測試專案，並且分別在 Android / iOS / UWP 底下來跑看看，看看這些問題的實際運作情況是如何，並且在不同作業系統平台下的表顯示否都是相同呢？
這篇文章所提到的範例程式碼，可以從 Github Xamarin2019 Repository 上取得。
使用 Visual Studio 產生一個 Xamarin.Forms for Prism 專案
- 開啟 Visual Studio 2019 程式
- 當 Visual Studio 2019 開始 視窗 出現之後，請點選左下角的 [建立新專案] 選項
- 當 [建立新專案] 對話窗出現之後，請在中間最上方的搜尋文字輸入盒中輸入 [prism] 關鍵字，搜尋所有與 Prism 有關的專案樣板
- 請選擇 [Prism Blank App (Xamarin.Forms)] 這個專案樣板
- 當出現 [設定新的專案] 對話窗，請在 [專案名稱] 輸入 [LayoutGesture]
- 最後點選該對話窗右下方的 [建立] 按鈕
- 現在將會看到 [PRISM PROJECT WIZARD] 對話窗，請勾選 ANDROID, iOS, UWP 三個行動裝置平台，接著在底下 [Container] 下拉選單，選擇 Unity 項目
- 最後，點選 [CREATE PROJECT] 按鈕，以便產生 Xamarin.Forms 專案
- 當這個 Xamarin.Forms 專案建立成功之後，請在該方案中，找到 Xamarin.Forms 使用的專案，這裡是名為 [LayoutGesture] 專案名稱，請在該專案中，使用滑鼠右擊 [相依性] 節點，選擇 [管理 NuGet 套件] 選項
- 在 [NuGet: LayoutGesture] 視窗中，點選 [瀏覽] 標籤頁次，並且在下方的搜尋文字輸入盒中，輸入 [propertychanged.fody] 關鍵字，搜尋出這個 NuGet 套件
- 當出現 [PropertyChanged.Fody] NuGet 套件，請點選該套件，並且點選右方的 [安裝] 按鈕，將這個套件安裝到 Xamarin.Forms 專案內
- 請查看 Xamarin.Forms 專案內，並沒有 [FodyWeavers.xml] 這個檔案，因此，使用滑鼠右擊 [LayoutGesture] 專案節點，選擇 [建置] 選項
- 當建置完成之後，在這個 Xamarin.Forms 專案內將會出現 [FodyWeavers.xml] 檔案
修正 View 與 ViewModel
- 在 Xamarin.Forms 專案內的 [Views] 資料夾內，找到 MainPage.xaml 檔案，並且打開它
- 使用底下 XAML 語言替換掉這個檔案內的 XAML 內容
<?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
x:Class="LayoutGesture.Views.MainPage"
Title="版面配置的手勢操作">
<Grid
RowSpacing="0" ColumnSpacing="0"
>
<Grid.RowDefinitions>
<RowDefinition Height="50"/>
<RowDefinition Height="*"/>
<RowDefinition Height="*"/>
<RowDefinition Height="*"/>
<RowDefinition Height="*"/>
<RowDefinition Height="*"/>
</Grid.RowDefinitions>
<Grid.GestureRecognizers>
<TapGestureRecognizer
Command="{Binding TapCommand}"
CommandParameter="透明的 Grid 觸發點選手勢"/>
</Grid.GestureRecognizers>
<Label
Grid.Row="0" Grid.Column="0"
HorizontalOptions="Center" VerticalOptions="Center"
Text="{Binding Hint}"/>
<StackLayout
Grid.Row="1"
>
<StackLayout.GestureRecognizers>
<TapGestureRecognizer
Command="{Binding TapCommand}"
CommandParameter="透明的 StackLayout 觸發點選手勢"/>
</StackLayout.GestureRecognizers>
</StackLayout>
<StackLayout
Grid.Row="2"
BackgroundColor="LightBlue"
>
<StackLayout.GestureRecognizers>
<TapGestureRecognizer
Command="{Binding TapCommand}"
CommandParameter="藍色背景的 StackLayout 觸發點選手勢"/>
</StackLayout.GestureRecognizers>
</StackLayout>
<BoxView
Grid.Row="3"
Color="LightGreen"
HorizontalOptions="Start" VerticalOptions="Center"
WidthRequest="100" HeightRequest="50"/>
<BoxView
Grid.Row="3"
Color="LightPink"
HorizontalOptions="End" VerticalOptions="Center"
WidthRequest="100" HeightRequest="50">
<BoxView.GestureRecognizers>
<TapGestureRecognizer
Command="{Binding TapCommand}"
CommandParameter="粉紅色背景的 BoxView 觸發點選手勢"/>
</BoxView.GestureRecognizers>
</BoxView>
<Button
Grid.Row="4"
HorizontalOptions="Start" VerticalOptions="Center"
Text="沒有設定 Command 的按鈕"/>
<Button
Grid.Row="4"
HorizontalOptions="End" VerticalOptions="Center"
Text="設定 Command 的按鈕"
Command="{Binding TapCommand}"
CommandParameter="設定 Command 的按鈕"/>
<Entry
Grid.Row="5"
Placeholder="請在這裡輸入"
HorizontalOptions="Center" VerticalOptions="Center"/>
</Grid>
</ContentPage>
- 在 Xamarin.Forms 專案內的 [ViewModels] 資料夾內，找到 MainPageViewModel.cs 檔案，並且打開它
- 使用底下 C# 敘述替換掉這個檔案內的 C# 敘述
namespace LayoutGesture.ViewModels
{
using System.ComponentModel;
using Prism.Events;
using Prism.Navigation;
using Prism.Services;
public class MainPageViewModel : INotifyPropertyChanged, INavigationAware
{
public event PropertyChangedEventHandler PropertyChanged;
public DelegateCommand<string> TapCommand { get; set; }
private readonly INavigationService navigationService;
public string Hint { get; set; }
public MainPageViewModel(INavigationService navigationService)
{
this.navigationService = navigationService;
TapCommand = new DelegateCommand<string>(x =>
{
Hint = x;
});
}
public void OnNavigatedFrom(INavigationParameters parameters)
{
}
public void OnNavigatedTo(INavigationParameters parameters)
{
}
public void OnNavigatingTo(INavigationParameters parameters)
{
}
}
}
建置與執行和測試結果
- 切換 Android 專案為預設起始專案，並且執行這個 Xamarin.Forms 到模擬器或者實體手機上
- 底下螢幕截圖為實際執行結果
現在，可以實際點選螢幕上的任何地方，並且觀察螢幕最上方的訊息文字，所以，可以得到底下結論：
- Layout 版面配置 與 View 檢視 可以設定使用 GestureRecognizers 屬性，指定不同的手勢觸發命令
- 若有多個 Layout 版面配置重疊，且這些版面配置都有設定使用 GestureRecognizers 屬性，當點選多個重疊在最上方版面配置區域的時候，最上方的版面配置之手勢命令將會被觸發，在底層的手勢命令不會被觸發
- 若版面配置的背景顏色為 透明色 Transparent ，還是依照上述的運作規則
- 若版面配置與檢視彼此重疊，也是依照上述的運作規則
- 若該檢視本身就具有手勢感應功能，例如，按鈕可以接收到使用者是否有點選這個按鈕、文字輸入盒可以接受使用者輸入文字等等，就算這些檢視沒有使用 GestureRecognizers 屬性，在底層的版面配置或者檢視也不會觸發相關手勢命令
2018/10/15
XAML in Xamarin.Forms 基礎篇 中文版電子書 (已推出)
對於已經具備擁有 .NET / C# 開發技能的開發者，可以使用 Xamarin.Forms Toolkit 開發工具，便可以立即開發出可以在 Android / iOS 平台上執行的 App；對於要學習如何使用 Xamarin.Forms & XAML 技能，現在已經推出兩本電子書來幫助大家學這這個開發技術。
這兩本電子書內包含了豐富的逐步開發教學內容與相關觀念、各種練習範例，歡迎各位購買。
想要購買
Xamarin.Forms 快速上手 電子書 (2019年11月 推出)，請點選 這裡
想要購買
XAML in Xamarin.Forms 基礎篇 電子書(2018年11月 推出)，請點選 這裡關於 XAML in Xamarin.Forms 基礎篇
這本書能提供什麼
在這本書裡面，將會設計 7 大部分
- 開發前的安裝、設定準備工作對於 Xamarin.Forms 開發新手，第一個學習卡關將會是如何安裝與設定一個可以進行 Xamarin.Forms 的開發環境；在這個部分將會詳細說明如何安裝與設定 Visual Studio 2017 ，使其可以順利的進行 Xamarin.Forms 的開發工作，並且也會介紹一個學習 XAML 宣告式標記語言的輔助工具，設計時期預覽工具 大金剛 Gorilla Player 與 執行時期預覽設計工具 LiveXAML，對於如何安裝與使用進行說明。
- 基本概念這個部分將會介紹您學習 XAML 語言必須要先瞭解的各種基本知識與觀念，讓您初步綜覽在學習 XAML 語言比須具備的基本技能。
- XAML 共用屬性我們將說明 XAML 提供的各種類別與其階層關係，這些類別將會被所使用的各種頁面、版面配置、檢視項目所繼承，因此，您可以從這些頁面、版面配置、檢視項目中，使用基底類別所提供的各種屬性、方法與事件。這些共用的基底類別包含了： 可綁定物件 BindableObject，項目 Element，視覺項目 VisualElement，頁面 Page，檢視 View，版面配置 Layout
- 各種不同頁面頁面是在 Xamarin.Forms 開發上，最為重要的使用者介面項目，當使用者在開啟此應用程式，第一個畫面內容就是一個頁面；原則上，我們進行 Xamarin.Forms 專案開發，就是要設計出各種不同頁面，並且根據應用程式設計需求，將這些頁面串接起來，提供使用者來操作這些頁面上設計的內容。Xamarin.Forms 內提供了這些頁面可供選擇：內容頁面、導航頁面、主從階層頁面、標籤頁面、旋轉木馬頁面。
- 各種不同版面配置我們要把各種 XAML 提供的視覺項目，定位在螢幕上的指定地方，並且可以根據螢幕的大小、解析度、密度來自動調整要顯示出我們所希望的結果，畢竟，要根據不同螢幕的大小、解析度、密度來設計出各種不同的 XAML 文件，這是相當麻煩的，因此，我們將會透過 XAML 中的版面配置來幫助我們自動做到這些事情。在 Xamarin.Forms 有提供眾多的版面配置，每個版面配置可以針對不同的設計情境來使用，這包括了：框架、內容檢視、堆疊方式版面配置、格線、捲動檢視、絕對版面配置、鄉對版面配置、彈性方塊版面配置。
- 各種不同檢視檢視是要提供與使用者互動的使用者介面，例如，讓使用者輸入文字、顯示出各種圖片、文字、請使用者選擇指定的日期與時間等等，在這部分將會帶領大家了解這些檢視的功能與使用方式。
- 各種資料綁定語法最後，會針對這本書上各種範例中有用到的資料綁定使用方式，進行完整的歸納與整理，讓您清楚了解如何在 XAML 中正確的使用資料綁定，來幫助您進行各種情境的 Xamarin.Fomrs 應用程式開發。
誰適合閱讀這本書
本書適合想要學會各種 XAML 開發技巧的開發者，將會提供基本 XAML 知識與觀念，不同 XAML 項目的使用與應用的介紹，當然，您還是需要擁有基本的 .NET C# 程式語言的開發經驗。
如何使用本書
在書中除了會提供各種學習 XAML 宣告式標記語言的內容，並搭配不同的應用程式範例進行介紹，從書中的第三部份，將會說明這段內容的講解範例是如何製作出來，希望讀者根據書中的說明步驟，搭配講解內容，逐一自我在電腦前面進行演練，可快速增加學習 XAML 的經驗值。
本書中的所有講解範例專案都會放在 Github 上，您可以透過 Github 的 XAMLInXamarin 來取得這些講解範例專案，並且鼓勵大家可以到這個 XAMLInXamarin Repository 頁面，在螢幕的右上方，點選 Start 按鈕給予鼓勵，如同下圖箭頭所指向地方。
關於 Xamarin.Forms 快速上手
這是一本帶領 Xamarin.Forms 新手開發者，可以透過書中介紹的各種知識、開發技能，配合練習專案實作，快速地學會使用 Xamarin.Forms 這個 UI Toolkit 來進行跨平台的行動應用裝置之應用程式開發工作。
這本書能提供什麼
在這本書裡面，將會提供 16 章的內容，分別是
- 開發前的安裝、設定準備工作(共有三章)對於 Xamarin.Forms 開發新手，第一個學習卡關將會是如何安裝與設定一個可以進行 Xamarin.Forms 的開發環境；在這個部分將會詳細說明如何安裝與設定 Visual Studio 2019 ，使其可以順利的進行 Xamarin.Forms 的開發工作。
- 使用 C# 程式語言來直接開發 Xamarin.Forms App說明如何僅使用 C# 程式語言，就可以開發出 Xamarin.Forms 的應用程式的開發過程。
- 使用 XAML 標記宣告語言來開發 Xamarin.Forms App說明使用 XAML 宣告標記語言來進行頁面畫面的內容宣告，相關的商業邏輯則是使用 程式碼後置 Code Behind 的方式來開發。
- 資料綁定 Data Binding資料綁定 Data Binding是在 Xamarin.Forms 開發上，最為重要的技術，對於資料綁定的類型共有三種，這裡將會針對一般資料物件類型的綁定設計方式來說明如何使用。
- 更多資料綁定的用法這裡將會繼續介紹更多關於資料綁定的不同使用方式。
- 數值轉換器 Value Converter對於資料綁定的設計方法下，數值轉換器的應用扮演者相當重要的角色，透過設計不同的數值轉換器類別可以設計出許多可重複使用的商業邏輯，並且輕鬆地將不同型別的綁定目標與綁定來源屬性串接在一起。
- 命令綁定 Command Binding命令綁定是資料綁定的第二種類型，透過命令綁定可以不再需要使用以往需要透過事件訂閱的設計方式，與在 程式碼後置 區塊來進行相關商業邏輯的程式碼設計工作，全部都轉移到綁定來源的類別物件上。
- 事件轉命令行為 Event to Command BehaviorXamarin.Forms 並不是所有的檢視項目都有提供可綁定的命令屬性，但是一定會有提供事件觸發的設計方式，在這裡將會使用 Xamarin.Forms 的一個核心技術 行為 Behaviors，將需要訂閱的事件與命令綁定在一起，這使得當事件被觸發的時候，可以執行所綁定的命令內的委派方法。
- 手勢操作 Gesture Recognizer在 Xamarin.Forms 內提供可以與使用者互動的項目不多，按鈕是其中一個，不過， Xamarin.Forms 提供了手勢辨識器功能，可以在讓何檢視項目上，宣告不同的手勢操作行為，當發生了這個手勢操作行為，將會觸發所指定的命令，例如，得知使用者點選了一個圖片 UI 控制項。
- MVVM Model-View-ViewModel 設計模式Xamarin.Forms 可以搭配 MVVM 的設計模式，讓 UI 視覺設計與呈現邏輯程式碼與商業邏輯程式碼分隔開來，這樣可以有助於程式開發流程、進行單元測試，因為，這解除了視覺控制項與程式碼之間的緊密耦合關係。
- 內建導航服務開發行動應用程式最為重要的設計工作，那就是能夠在不同的頁面之間進行切換，在這裡會先進行 Xamarin.Forms 預設提供的導航服務功能進行介紹，並且了解到更多設計上的問題，可能需要進一步的解決。
- 導航服務之封裝設計為了要解決 Xamarin.Forms 預設的導航服務的不足，已經可以在檢視模型中進行各種頁面導航操作，在這裡將會設計一個延伸導航服務類別，解決相關問題，讓開發過程更加的順暢。
- 相依服務 Dependency ServiceXamarin.Forms 是個 UI 開發工具，它把 UI 設計抽象化了，並且可以讓使用 Xamarin.Forms 設計的 UI 畫面可以在不同平台下來顯示出來，可是，當需要某些功能一定需要透過原生 SDK API 才能夠運作的需求，並且取得原生 SDK API 的執行結果，這個時候就可以透過 Xamarin.Forms 提供的相依服務來滿足這樣的工作。
- 訊息中心 MessagingCenter訊息中心是一種
發行-訂閱模式，其中對於 發行者 這個角色可以在不知道任何 訂閱者 的情況下傳送訊息。 同樣地，訂閱者 也可以在不知道任何 發行者 的情況下訂閱特定訊息。透過這樣的特行，可以讓 Xamarin.Forms 的程式順利地執行原生平台下的 SDK API。
誰適合閱讀這本書
本書適合想要學會如何使用 Xamarin.Forms 工具來開發出跨平台的行動應用程式的開發者，這裡將會介紹各種 Xamarin.Forms 核心與應用開發技術與技巧，並且帶領大家了解到進階的開發技能，如：檢視模型定位器，延伸導航服務等。透過學習這些開發技術，將會有助於進行各種 Xamarin.Forms 應用程式開發能力的提升。
不過，讀者本身應該要具備 .NET / C# 的開發經驗與程式寫作技能，並且要有使用過 Visual Studio 2019 開發經驗。
這本書的範例專案將會是在 Windows 10 作業系統下，使用 Visual Studio 2019 開發工具開發出來的，由於使用 Xamarin.Forms 開發出來的專案可以在 Android / iOS / UWP 平台下執行，若想要體驗開發出來的專案且在 iOS 模擬器環境下執行效果，讀者需要額外準備一台 Mac 電腦，並且在這台電腦上需要安裝 Xcode 與 Visual Studio for Mac 開發工具。
如何使用本書
在書中每個章節都設計了一個練習專案，透過逐步說明的方式來帶領讀者來了解到 Xamarin.Forms 專案是如何進行開發的，了解到為什麼需要使用這樣的開發方式與和其他設計方式差異。
本書中的所有講解範例專案都會放在 Github 上，您可以透過 Github 的 Xamarin-Forms-Quick-Start 來取得這些講解範例專案，並且鼓勵大家可以到這個 Xamarin-Forms-Quick-Start Repository 頁面，在螢幕的右上方，點選 Start 按鈕給予鼓勵，如同下圖箭頭所指向地方。
了解更多關於 [Xamarin.Android] 的使用方式
了解更多關於 [Xamarin.iOS] 的使用方式
了解更多關於 [Xamarin.Forms] 的使用方式
了解更多關於 [Hello, Android：快速入門] 的使用方式
了解更多關於 [Hello, iOS – 快速入門] 的使用方式
了解更多關於 [Xamarin.Forms 快速入門] 的使用方式
訂閱：
文章 (Atom)
Visual Studio 2019 for Xamarin 之安裝與設定 Part2 - Visual Studio 2019 安裝與相關相關設定 1
Visual Studio 2019 for Xamarin 之安裝與設定 Part3 - Visual Studio 2019 安裝與相關相關設定 2
Visual Studio 2019 for Xamarin 之安裝與設定 Part4 - 安裝 Android 使用的模擬器
Visual Studio 2019 for Xamarin 之安裝與設定 Part5 - 測試與確認開發環境可以進行 Xamarin.Forms 專案開發與結論
Xamarin.Forms 快速上手電子書，請點選 這裡XAML in Xamarin.Forms 基礎篇電子書，請點選 這裡安裝前的準備工作
確認作業系統版本
確認硬體 BIOS 有啟用虛擬化功能
停用 Hyper-V
啟用 UWP 開發人員模式
準備一台 macOS 的電腦主機