Xamarin.iOS - 利用Settings插件與EAIntroView制作App的歡迎界面

Xamarin.iOS - 利用Settings插件與EAIntroView制作App的歡迎界面

關于歡迎界面

很多App第一次啟動都會有一個歡迎界面，歡迎界面往往決定這用戶對App的第一映像，所以歡迎界面的重要性不言而喻。QQ、微博、知乎等App都有制作精良的歡迎界面。

大多數歡迎界面由幾個界面組成，通常界面上會有一張背景圖和簡單的介紹文字，頁面直接的切換類似于Android的ViewPager一樣，靠左右滑動來切換。通常會提供了一個Skip按鈕來讓用戶跳過歡迎界面。

本文將告訴你如何制作一個歡迎界面。

需要用到的第三方庫

• EAIntroView（Object-C寫的歡迎界面第三方庫） https://github.com/ealeksandrov/EAIntroView
• Settings插件 (JamesMontemagno制作的插件之一，用來記錄App的設置數據） https://github.com/jamesmontemagno/Xamarin.Plugins/tree/master/Settings

一、綁定EAIntroView

為了使用EAIntroView我們首先需要將源生的Ojbect-C庫綁定成Xamarin能用的程序集。Xamarin綁定請參考Xamarin官網的教程，我只會講主要的操作和貼一些關鍵的代碼。

http://developer.xamarin.com/guides/ios/advanced_topics/binding_objective-c/

在有了Objective Sharpie后綁定已經比較方便了，基本上只要稍微修改下自動生成ApiDefinitions文件即可。

1.獲取EAIntroView源代碼

用git命令將EAIntroView克隆下來，并稍微瀏覽下源生的Ojbect-C代碼

git clone https://github.com/ealeksandrov/EAIntroView.git

2.生成靜態庫

在XCode中建立新的iOS Cocoa Touch Static Library，名字叫做EAIntroViewStatic。

將EAIntroView的源代碼文件（EAIntroView文件夾中，共4個）復制到XCode的工程中。

按下Command+B編譯，我們會發現提示缺少了EARestrictedScrollView相關的文件。這是因為EAIntroView依賴于EARestrictedScrollView造成的，EARestrictedScrollView是EAIntroView的作者的另一個第三方庫。

和EAIntroView一樣，在源生開發中也是利用CocoaPod將源代碼文件引用到當前工程中的，所以我們到Example/Pods/EARestrictedScrollView文件夾中將EARestrictedScrollView的源代碼復制到我們的工程中來。再修改下頭文件的引用就OK了。

再次按下Command+B就提示Build Successed了。

當目標平臺為iOS Device時會顯示Build Faild，為了在真機中可以使用，我們需要進行簽名。點擊工程，就可以進入設置界面，在Build Setting中的Code Signing Idtntity中選擇iOS Developer。

3.制作模擬器與真機都能使用的通用類庫

然后我們需要將.a文件制作成通用類庫

參考這篇文章官網的綁定教程中也有提及

為了方便我給出Makefile，按照上述操作進行過代碼簽名后可以用make命令方便的生成模擬器和真機（32位、64位）都可以使用的.a文件，如果你開始和我的工程名不一樣的話請注意修改。

XBUILD=/applications/Xcode.app/Contents/Developer/usr/bin/xcodebuildPROJECT_ROOT=.PROJECT=$(PROJECT_ROOT)/EAIntroViewStatic.xcodeprojTARGET=EAIntroViewStaticall: libEAIntroView.alibEAIntroView-i386.a:$(XBUILD) -project $(PROJECT) -target $(TARGET) -sdk iphonesimulator -configuration Release clean build-mv $(PROJECT_ROOT)/build/Release-iphonesimulator/lib$(TARGET).a $@libEAIntroView-armv7.a:$(XBUILD) -project $(PROJECT) -target $(TARGET) -sdk iphoneos -arch armv7 -configuration Release clean build-mv $(PROJECT_ROOT)/build/Release-iphoneos/lib$(TARGET).a $@libEAIntroView-arm64.a:$(XBUILD) -project $(PROJECT) -target $(TARGET) -sdk iphoneos -arch arm64 -configuration Release clean build-mv $(PROJECT_ROOT)/build/Release-iphoneos/lib$(TARGET).a $@libEAIntroView.a: libEAIntroView-armv7.a libEAIntroView-i386.a libEAIntroView-arm64.alipo -create -output $@ $^clean:-rm -f *.a *.dll

libEAIntroView.a文件就是最終的生成結果。

4.利用Objective Sharpie工具進行綁定

首先還是在Xamarin中建立iOS Binding Project。

將剛剛生成的.a文件拖入到工程中，并修改linkWith描述文件

using System;using ObjCRuntime;[assembly: LinkWith("libEAIntroView.a", LinkTarget.ArmV7 | LinkTarget.Simulator | LinkTarget.Arm64 | LinkTarget.ArmV7s | LinkTarget.Simulator64, SmartLink = true, ForceLoad = true)]

然后用Objective Sharpie將Object-C的頭文件翻譯成ApiDefinitions具體的教程我也不寫了，官網已經非常詳細了，下面是要執行的命令

sharpie bind --output=EAIntroView --namespace=EAIntroView --sdk=iphoneos8.2  [項目的絕對路徑]/EAIntroViewStatic/*.h

生成ApiDefinitions.cs和StructsAndEnums.cs后覆蓋Binding項目的同名文件。

然后還需要進行少量的修改，主要是同名函數的問題（Object-C的函數名由函數名+參數名決定，所以當函數名相同而參數名不同時C#沒辦法分辨，只要改改函數名就行），還有幾個提示是需要需要用強類型替換NObject類型，這個我們可以先不管。

ApiDefinitions.cs文件太長我就不貼了，到時候會放在Github上。

至此我們生成了Xamarin能使用的dll文件。

二、Settings插件的使用

1.安裝Settings插件

有2種方式

• 通過Nuget包管理器下載
• 通過源代碼自己編譯

這里我們用Nuget省事，在Nuget命令行中輸入如下的命令即可。

Install-Package Xam.Plugins.Settings

另外iOS需要這樣設置下，啟用Generic Value Type Sharing

2.基本教程

參考

• http://components.xamarin.com/gettingstarted/settingsplugin
• https://github.com/jamesmontemagno/Xamarin.Plugins/tree/master/Settings

主要是CrossSettings.Current對象和它的2個函數GetValueOrDefault、AddOrUpdateValue，這2個函數的功能看名字應該就非常清楚了。