寫Xamarin.iOS很常會用到Native iOS的原始碼，所以把這轉換技術學起來，就不太需要再寫一次程式碼囉！

1. Xamarin.iOS中引用自製
Objective-C的Class Library
HappyMan
2015/02/03

2. 目標
• 在Xamarin.iOS中使用我們自行在Xcode中
開發的Objective-C Class Library

3. 步驟
1. 在Xcode中建立Static Library
2. 編譯此Static Library，使它能同時支援iOS
Device與iOS simulator硬體架構
3. 使用Objective Sharpie Tool產生轉換
Objective-C到C#的程式碼
4. 在Xamarin中建立iOS Binding Project
5. 在Xamarin中建立iOS APP專案，引用iOS
Binding Project

4. 建立Static Library
• 在Xcode創建新專案，選擇iOS ->
Framework & Library -> Cocoa Touch
Static Library。在此命名為ShareCode

5. 專案結構
• 我們來宣告並實作一個帶有參數型態
NSString且回傳值型態NSString的方法

6. ShareCode.h
• #import <Foundation/Foundation.h>
• @interface ShareCode : NSObject
• - (NSString *)sayHello:(NSString *)name;
• @end

7. ShareCode.h
• #import "ShareCode.h"
• @implementation ShareCode
• -(NSString *)sayHello:(NSString *)name {
• return [NSString stringWithFormat:@"Hello %@ :)", name];
• }
• @end

8. 專案中的目錄結構
• 在命令提示字元介面中以Xcodebuild編譯這
個專案

9. 產生iOS Simulator用的檔案
• xcodebuild -sdk iphonesimulator -configuration
Debug
– Build settings from command line:
– SDKROOT = iphonesimulator8.1
– === BUILD TARGET ShareCode OF PROJECT ShareCode
WITH CONFIGURATION Debug ===
– Check dependencies
– Write auxiliary files
– …
– ** BUILD SUCCEEDED **

10. 產生iOS Device用的檔案armv7
• xcodebuild -sdk iphoneos -arch armv7 -
configuration Debug
– Build settings from command line:
– ARCHS = armv7
– SDKROOT = iphoneos8.1
– === BUILD TARGET ShareCode OF PROJECT ShareCode
WITH CONFIGURATION Debug ===
– Check dependencies
– Write auxiliary files
– ** BUILD SUCCEEDED **

11. 產生iOS Device用的檔案armv7s
• xcodebuild -sdk iphoneos -arch armv7s -
configuration Debug
– Build settings from command line:
– ARCHS = armv7s
– SDKROOT = iphoneos8.1
– === BUILD TARGET ShareCode OF PROJECT ShareCode
WITH CONFIGURATION Debug ===
– Check dependencies
– Write auxiliary files
– ** BUILD SUCCEEDED **

12. 產生iOS Device用的檔案arm64
• xcodebuild -sdk iphoneos -arch arm64 -
configuration Debug
– Build settings from command line:
– ARCHS = arm64
– SDKROOT = iphoneos8.1
– === BUILD TARGET ShareCode OF PROJECT ShareCode
WITH CONFIGURATION Debug ===
– Check dependencies
– Write auxiliary files
– ** BUILD SUCCEEDED **

13. 專案中的目錄結構
• ShareCode -> build
• 我在名稱後綴加入arm7 arm7s arm64以利
分辨

14. Static Library
• 檔案來源：build -> Debug-iphoneos_arm*
• 重新命名：libShareCode.a
– libShareCode_arm64.a
– libShareCode_armv7s.a
– libShareCode_armv7.a
– libShareCode_simulator.a
• 轉放至專案資料夾：ShareCode

15. 合併為一
• 使用lipo指令將.a檔案包成單一檔案
• lipo -create -output ShareCode.a
libShareCode-arm64.a libShareCode-
armv7s.a libShareCode-armv7.a
libShareCode-simulator.a
• 於是產生ShareCode.a

16. 建立Xamarin.iOS Binding Project
• C# -> iOS -> Unified API -> iOS Binding Project

17. 檔案結構(前)

18. 加入Static Library

19. 加入Static Library

20. 加入Static Library

21. 檔案結構(後)

22. ShareCode.linkwith.cs
• using System;
using ObjCRuntime;
[assembly: LinkWith (“ShareCode.a”, LinkTarget.Arm64 |
LinkTarget.ArmV7s | LinkTarget.ArmV7 | LinkTarget.Simulator, SmartLink =
true, ForceLoad = true)]

23. 使用Objective Sharpie
• Objective Sharpie is a command line tool
(provided by Xamarin) that can assist in
creating the definitions required to bind a
3rd party Objective-C library to C#.
• 下載並安裝
– http://files.xamarin.com/~abock/ObjectiveShar
pie/ObjectiveSharpie-1.1.1.pkg

24. 查看Xcode SDK
• sharpie xcode -sdks
– macosx10.8
– macosx10.9
– iphoneos7.1
– iphonesimulator7.1
– macosx10.10
– iphoneos8.2
– iphonesimulator8.2
– iphoneos8.1
– iphonesimulator8.1

25. 轉換ShareCode.h
• sharpie bind -output ShareCode -namespace
ShareCode -sdk iphoneos8.2 ShareCode.h –unified
– Compiler configuration:
– -isysroot /Applications/Xcode-
Beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs
/iPhoneOS.sdk -miphoneos-version-min=8.2 -resource-dir
/Library/Frameworks/ObjectiveSharpie.framework/Versions/1.1.1/clang-
resources -arch armv7 -ObjC
– Parsing...
– [ 0%] parsing /Users/jason/Xcode/ShareCode/ShareCode.h
– [100%] parsing complete
– Binding...
– [bind] generating ShareCode.cs
– Submitting usage data to Xamarin...
– Submitted - thank you for helping to improve Objective Sharpie!
– Done.

26. 生成ShareCode.cs
• namespace ShareCode {
// @interface ShareCode : NSObject
[BaseType (typeof (NSObject))]
interface ShareCode {
// -(NSString *)sayHello:(NSString *)name;
[Export ("sayHello:")]
string SayHello (string name);
}
}
• 將它複製到ApiDefinition.cs

27. ApiDefinition.cs
• using System;
using System.Drawing;
using ObjCRuntime;
using Foundation;
using UIKit;
namespace ShareCode {
// @interface ShareCode : NSObject
[BaseType (typeof (NSObject))]
interface ShareCode {
// -(NSString *)sayHello:(NSString *)name;
[Export ("sayHello:")]
string SayHello (string name);
}
}

28. 編譯釋出

29. 產生BindingProjectTest2.dll
• BindingProjectTest2 ▸ BindingProjectTest2 ▸
bin ▸ Release ▸ BindingProjectTest2.dll

30. 建立Xamarin.iOS Project

31. 檔案架構

32. 引用BindingProjectTest2產生的檔
• Project -> Edit References

33. 引用BindingProjectTest2產生的檔
• Browse -> BindingProjectTest2 ▸
BindingProjectTest2 ▸ bin ▸ Release ▸
BindingProjectTest2.dll

34. MainStoryboard.storyboard
• 建立一個Label

35. MainStoryboard.storyboard
• 設定Label屬性

36. BindingSample2ViewController.cs
• public override void ViewDidLoad ()
{
base.ViewDidLoad ();
// Perform any additional setup after loading the view,
typically from a nib.
var obj = new ShareCode.ShareCode ();
this.helloLabel.Text = obj.SayHello ("HappyMan");
}

37. 編譯執行
• iOS Simulator (iPhone 6)
• iOS Device (iPhone 6)

38. 結論
• 使用Objective-C Library轉到C# Library角
色有三個專案，範例：
– ShareCode (Xcode)
– BindingProjectTest (Xamarin)
– BindingSample (Xamarin)
• https://github.com/happymanx/Binding-
Library-from-ObjC-to-CSharp.git

39. 參考
• [Xamarin.iOS] 如何引用Objective-C寫的
Class Library
http://www.dotblogs.com.tw/toysboy21/archive/2013/08/27/115697.aspx
• Xamarin - Walkthrough: Binding an
Objective-C Library
http://developer.xamarin.com/guides/ios/advanced_topics/binding_objective-
c/Walkthrough_Binding_objective-c_library/