Xamarin FAQ 1-007 : 如何清除導航堆疊 (Navigation Stack)

問題

根據當時應用程式的操作流程，會需要轉跳到某個頁面，此時，螢幕上不會有回上一頁的導航按鈕出現，必且，手機的實體回上一頁按鍵，當您按下之後，這個應用程式就會直些回到手機桌面，並不會跳到之前來的頁面。最經典的使用案例那就是，使用者可以在應用程式的任何地方，點選 登出 功能選項，接著，應用程式就會跳到 登入 頁面上，此時，這個頁面就會成為這個應用程式的首頁，因為導航堆疊已經被清空了，所以，當按下實體按鍵的回上一頁按鈕，此時，應用程式也就回到背景模式，手機桌面也就出現了。

解答

想要解決這個問題，可以使用底下程式碼

        public YourConstructor(INavigationService navigationService)
        {
            _navigationService = navigationService;
            登出Command = new DelegateCommand(() =>
            {
                await _navigationService.NavigateAsync("xf:///MDPage/NaviPage/LoginPage");
            });
        }|

在這個範例程式碼中，當您需要導航到 登入 頁面的時候 (LoginPage)，請使用絕對路徑的 URI 來表示，而不要使用相對路徑，例如：await _navigationService.NavigateAsync("LoginPage");，如此，當切換到 登入 頁面之後，應用程式的導航堆疊也就清空了。

Xamarin 必學的核心功能 您都學會了嗎？

身為專業的 Xamarin 程式設計師，這些Xamarin 必學的核心功能：Renderer，相依性服務注入，事件聚合器(事件中心)，可綁定屬性，附加屬性，客製控制項，使用者控制項，OnPlatform，非同步方法呼。

您都學會了嗎？ ^_^

想要進階提升您的 Xamarin.Froms 開發能力與實力嗎?

那您一定不能錯過 Charles Petzold 大師著作的 Creating Mobile Apps with Xamarin.Forms 一書，共有1200頁以上內容，最重要的是，這本書完全免費，真是佛心來也。

Chapter 1. How Does Xamarin.Forms Fit In?
Chapter 2. Anatomy of an App
Chapter 3. Deeper into Text
Chapter 4. Scrolling the Stack
Chapter 5. Dealing with Sizes
Chapter 6. Button Clicks
Chapter 7. XAML vs. Code
Chapter 8. Code and XAML in Harmony
Chapter 9. Platform-Specific API Calls
Chapter 10. XAML Markup Extensions
Chapter 11. The Bindable Infrastructure
Chapter 12. Styles
Chapter 13. Bitmaps
Chapter 14. Absolute Layout
Chapter 15. The Interactive Interface
Chapter 16. Data Binding
Chapter 17. Mastering the Grid
Chapter 18. MVVM
Chapter 19. Collection Views
Chapter 20. Async and File I/O
Chapter 21. Transforms
Chapter 22. Animation
Chapter 23. Triggers and Behaviors
Chapter 24. Page Navigation
Chapter 25. Page Varieties
Chapter 26. Custom Layouts
Chapter 27. Custom renderers
Chapter 28. Location and Maps

Xamarin FAQ 1-06 : 那些 Android SDK 套件需要使用 Android SDK Manager 來安裝呢?

問題

很多人在進行 Android 專案開發的時候，往往會遇到一些奇怪的問題，甚至在要建置專案的時候，就會產生相當多的錯誤訊息，如 Android.Support.V4.Widget.DrawerLayout.AddDrawerListener；其實，很多時候，這是您的 Android SDK Manager 並沒有安裝與設定完全。

解答

• 請先安裝 Java JDK 1.8 以上的版本到您的電腦上
  ( JDK 可以到 Oracle 網站上下載 http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html )
• 在 Visual Studio 2015 中，點選功能表 工具 > 選項 > Xamarin > Android Settings
• 請設定 Java Development Kit Location 這個欄位，指向您 JDK 1.8 版本安裝的位置，例如： C:\Program Files\Java\jdk1.8.0_102
• 在 Visual Studio 2015 中，點選功能表 工具 > Android > Android SDK Manager
• 在 Android SDK Manager 請確認底下項目已經確實有安裝且安裝到最新版本
  • Tools > Android SDK Tools
  • Tools > Android SDK Platform-tools
  • Tools > Android SDK Builder-tools ( 這裡僅需要安裝最新版本，舊的本版可以移除，不會有影響)
  • 每個 Android 版本內的 SDK Platform 項目要安裝 ( 在這裡建議把 Android 4.4.2 (API 19) 以上的各 Android 版本內的 SDK Platform 都安裝起來 )
  • Extras > Android Support Repository
  • Extras > Google USB Driver

Xamarin FAQ 1-005 : 如何在原生專案使用 Prism 事件聚合器 (Event Aggregator)來非同步呼叫核心 PCL 專案內方法

問題

有時候，當程式碼已經轉移到原生專案組件內執行了，此時，您要用非同步的使用核心 PCL 專案內的某個方法，例如，呼叫核心 PCL 專案內的某個方法，使用導航物件進行頁面導航的工作，這個要如何做到呢?

解答

要解決這樣的需求，請依照底下的步驟進行操作。

• 請先取得這個應用程式的 Prism 容器 ( Container )，請使用底下方法取得 Prism 容器

            // 取得 Prism 相依性服務使用到的容器
            IUnityContainer fooContainer = (XFoAuth2.App.Current as PrismApplication).Container;

• 接著，解析出這事件聚合器 (Event Aggregator)介面的實作物件，一旦您取得了這個實作物件，您就可以使用 Prism 的事件訂閱或者發佈事件功能。

            // 取得 IAccountStore 介面實際實作的類別物件
            var fooIEventAggregator = fooContainer.Resolve<IEventAggregator>();

• 在底下的範例中，會根據 e.IsAuthenticated 的值內容，使用 Prism 的事件聚合器 (Event Aggregator)，送出不同的事件訊息給核心 PCL 專案的訂閱者。

            if (e.IsAuthenticated)
            {
                fooIEventAggregator.GetEvent<AuthEvent>().Publish(AuthEventEnum.身分驗證成功);
            }
            else
            {
                fooIEventAggregator.GetEvent<AuthEvent>().Publish(AuthEventEnum.身分驗證失敗);
            }

• 在核心 PCL 專案內，使用了 Prism 的事件聚合器 (Event Aggregator)訂閱了這個事件，一旦非同步收到這個訊息，就會回到上一頁頁面。

        public oAuthPageViewModel(INavigationService navigationService, IEventAggregator eventAggregator)
        {

            _eventAggregator = eventAggregator;
            _navigationService = navigationService;

            // 訂閱使用者認證結果通知事件，認證成功之後，會收到 Success
            fooSubscriptionToken = _eventAggregator.GetEvent<AuthEvent>().Subscribe(async x =>
              {
                  await _navigationService.GoBackAsync();
              });
        }




對於 Xamarin 技能實驗室的建議

若您對於  Xamarin 技能實驗室有：

• 任何的建議與指教
• 想要了解的 Xamarin 相關技術或文章
• 提供想要寫入 Xamarin FAQ 內的文章
• 關於 Xamarin 教育訓練課程的問題

歡迎您在這篇文章留言處，寫下您的意見，感謝您的支持。

Xamarin FAQ 1-004 : 如何從PCL來同步呼叫原生專案內實作方法

問題

在進行 Xamarin.Forms 專案開發的時候，必定會使用這這樣的需求，那就是有些功能在核心 PCL 專案內是無法使用的，需要在原生專案內實作出這些功能，並且，在每個不同平台的原生專案內，又需要使用不同原生專案支援的類別庫，來完成這些功能需求。這個時候，您可以使用 Prism 的相依性服務機制，在每個不同平台來實作出這些功能，透過相依性服務注入機制，在檢視模型 (ViewModels)內，使用建構式注入的方式，取得這些實作物件，如此，就可以在核心 PCL 專案內呼叫這些原生專案獨有的功能了。

解答

要解決這樣的需求，請依照底下的步驟進行操作。

• 首先，在核心 PCL 專案內，產生一個介面 (Interface)，在這個介面內宣告出共用的方法。在底下，定義了一個介面，裡面有個方法 GetPlatformName，我們期望能夠在核心 PCL 專案內呼叫這個方法，就可以知道當時是在哪個平台作業系統上執行。

    public interface INatvieAssyFile
    {
        /// <summary>
        /// 取得作業系統版本名稱
        /// </summary>
        /// <returns></returns>
        string GetPlatformName();
    }

• 接著，您需要在每個原生平台(Android, iOS, UWP)專案中，產生一個類別，並且實作出這個介面功能。在底下的範例中，我們產生了一個 NatvieAssyFile類別，並且實作了介面 INatvieAssyFile的功能；因為這個類別是定義在 iOS 專案內，所以方法 GetPlatformName() 就僅會回傳 iOS 這個字串。
  如此，當這個 Xamarin.Forms 的專案在 iOS 系統下運行的時候，並且程式在核心 PCL 專案內執行呼叫 GetPlatformName()方法，就會得到了 iOS 這個字串；當然，您需要其他原生專案內也實作出同樣的類別，並且回傳當時作業系統的文字。
• 另外，您需要在 namespace 前面，宣告這個類別可以具備相依性服務注入的能力，在這個範例中，使用了這樣的語法 [assembly: Xamarin.Forms.Dependency(typeof(NatvieAssyFile))]。加入了這行，您就可以在核心 PCL 專案內，使用建構式注入的方式，取得這個實作物件了。

[assembly: Xamarin.Forms.Dependency(typeof(NatvieAssyFile))]
namespace XFFiles.iOS.Services
{
    class NatvieAssyFile : INatvieAssyFile
    {
        public string GetPlatformName()
        {
            return "iOS";
        }
    }
}

• 最後，我們來看如何在核心 PCL 專案內，取得這個注入物件；要做到取得注入物件，請參考底下步驟：
  • 宣告一個 INatvieAssyFile 介面變數，用來持有注入後的實作物件。
  • 在檢視模型的建構式中，加入這個引數 INatvieAssyFile natvieAssyFile。
  • 在檢視模型的建構式裡面，將剛剛注入進來的物件，設定讓欄位變數可以持有這個傳入的物件。

        private readonly INavigationService _navigationService;
        private readonly INatvieAssyFile _natvieAssyFile;
        #endregion

        #region Constructor 建構式
        public MainPageViewModel(INavigationService navigationService, INatvieAssyFile natvieAssyFile)
        {

            _navigationService = navigationService;
            _natvieAssyFile = natvieAssyFile;
            ...
        }




Xamarin FAQ 1-003 : 如何使用容器註冊介面與實作物件

問題

在 Xamarin.Forms 內，若您使用了 Prism Template Pack 來建立一個檢視 (View)，此時，Visua Studio 除了幫您建立一個 XAML 檢視頁面之外，還會幫您一併在 ViewModels 資料夾下也建立一個檢視模型，有些時候，想要在核心 PCL 專案內或只者原生專案內，註冊一個介面與其實作類別，那麼該怎麼做呢?

解答

這個時候，您需要先取得 Prism 的容器 Container，接著使用該容器提供的 RegisterType 方法，不過，需要將介面與實作類別型別使用泛型方式傳入進去，這樣就完成了註冊的工作。

經過這樣的註冊程序，若要透過相依性服務取得實作的物件，則是具備了短暫(transient)生命週期(lifetime)；也就是，每進行注入解析動作，就會產生一個不同的物件出來。

myContainer.RegisterType<IMyClass, MyClass>();

Xamarin FAQ 1-002 : 如何不透過建構式注入的方式，取得特定介面的實作物件

問題

當我們在使用 Prism 相依性服務注入功能的時候，通常會使用建構式注入方式，取的介面的實作物件，但有些時候，我們希望直接透過容器來取得這個實作物件，那麼，該如何做到呢?

解答

當您已經取得了 Prism 的容器物件，例如，該容器儲存在 myContainer 這個物件內，您可以使用 myContainer.Resolve<IMyInterface>(); 這樣的方式，取得介面 IMyInterface 的實作物件到 fooObject內。

+

IMyInterface fooObject = myContainer.Resolve<IMyInterface>();

Xamarin FAQ 1-001 : 如何取得 Prism 的容器 Container 物件

問題

當您需要使用 Prism 功能，進行相依性服務的註冊與解析功能的時候，需要取得 Prism 的容器 Container 物件，那麼，在不同的組件 (Assembly)中(原生專案或者核心 PCL 專案)，要如何取得這個容器物件呢？

解答

想要取得 Prism 的容器物件，可以使用底下程式碼

IUnityContainer myContainer = (App.Current as PrismApplication).Container;

這樣就可以取得 IUnityContainer 的容器物件，透過這個物件，您可以輕鬆的進行注入您所想要的相依性物件到您現在的類別方法內。