Xamarin.iOS使用Objective-C静态类库.a(Linking Native Libraries)

2024-06-23 02:58
文章标签 类库 xamarin ios objective linking native libraries 静态 使用

本文主要是介绍Xamarin.iOS使用Objective-C静态类库.a(Linking Native Libraries)，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

 Xamarin静态类库的binding实际上是一个C#与Objective-C方法间映射过程，由于第三方SDK对iOS开发至关重要，因此官方文档中也对这块也做了完整的介绍（Binding Objective-C Libraries），但对于一个完全入门级的程序员来说，这块还是有诸多麻烦，并且部分Api类型文档上也未曾提到。下面将以百度地图作为案例，全面解析静态类库binding工程的知识与问题（Mac OS 10.8.4及以上系统）。生成dll过程：

    在开始之前需要了解几个iOS原生开发中的基础知识： 

     1.Command Line Tools for Xcode(XCode命令行工具)

      里面包含了一些常用的命令，在处理静态类库时经常用到，有两种安装方法：

      1）是在Xcode设置>>Downloads更新安装；

      2）使用Mac os下“终端”中敲入命令 xcode-select --install 安装即可。

  
    2.静态类库(.a)编译类型
    由于iOS编译机制上的区分，静态类库分为模拟器(i386)，真机（ARMv7/ARMv7s/ARMv64等），这是由设备CPU决定的。一般厂商提供的静态类库都会分别提供（例如BaiduMap：Release-iphoneos(真机)/Release-iphonesimulator(模拟器)），那在没有明确标识的情况下，我们怎么区分这些静态类库是真机还是模拟器呢？简单直观的查看方法，打开Xamarin Studio，新建BindingProject，然后将[libBaidu.a]添加到工程上，打开自动生成的linkwith.cs文件就可以查看到静态类库的类型【可参考Monotouch BindingProject之友盟SDK】。


    

    3.真机模拟器通用静态类库.a生成
    为什么要使用这种通用类库？方便你模拟器真机调试。由于通用包比原来增加接近一倍，因此发布的时候记得只使用真机包，以减少.ipa的大小。操作方法：
    1）在桌面新建文件夹[BaiduLib]，打开终端，输入命令cd，并且拖动[BaiduLib]到终端命令后面，按回车（意在将文件默认保存在此文件夹下）。
    2）接着输入命令lipo -create [libbaidumapapi.a] [libbaidumapapi.a] -output libBaiduSDK.a，（其中[libbaidumapapi.a] [libbaidumapapi.a]只要拖动到终端框内即可）敲回车，稍等片刻就可以在文件夹[BaiduLib]下看到[libBaiduSDK.a],将其添加到Binding工程中就可以查看到三种类型都存在：LinkTarget.Simulator | LinkTarget.ArmV7 | LinkTarget.ArmV7s




3) 输入命令lipo -info libBaiduSDK.a 来检测.a文件支持的系统架构。

    4.Framework系统框架引用
     几乎每个静态类库的实现都引用了或多或少的系统framework，规范的静态类库引用都会提醒你使用了哪些系统framework，而在xcode中添加是件简单的事，但在xamarin studio中地却要使用gcc命令来添加。文档中有介绍：【Linking Your Library】
     注意几个关键字：
     1）-gcc_flags，普通native library编译
     2）-cxx，包含C++代码类型编译
     3）-L${ProjectDir}，当前文件目录
     4）-framework，框架类型，例如：[-framework CFNetwork]
     5）--registrar:legacy，引用文档解释：The new registrars (first introduced in 6.2.6) are now enabled by default. They catch many more errors and will prevent many bugs or undefined runtime behaviors. It is possible to fallback to the previous registrars by using --registrar:legacy as an additional mtouch argument。简单来说应该是编译器版本问题的一个控制开关;
     6）-ObjC，一般放命令行尾部，需要时添加

     完整的命令，以百度地图为例：

[csharp]  view plain copy
  1. --registrar:legacy -cxx -gcc_flags "-L${ProjectDir} -framework MapKit -framework CoreLocation -framework QuartzCore  -framework OpenGLES  -framework SystemConfiguration -framework CoreGraphics -framework Security -ObjC"  
     命令添加在UI工程中，工程选项>>iOS Build>>Additional Options>>Additional mtouch arguments      

     5.C#与ObjC数据类型

     

    了解完Xamarin.iOS的基础所需，正式开始接下来繁多无味而重要的映射方法binding工作，当然xamarin官方也提供了一个自动生成工具，但这个工具给我感觉不太能用，也许没深入研究吧，感兴趣的朋友可以下载试用一下【objective_sharpie】（如果你还无法开始时，建议参考【友盟SDK的调用】）。 

    开始之前简单介绍一下：
一个头文件中可以出现多个@interface，每个@interface在C#中都是一个类，例如：BMKActionPaopaoView.h文件：

[objc]  view plain copy
  1. @interface BMKActionPaopaoView : UIView  
  2. - (id)initWithCustomView:(UIView*)customView;  
  3. @end  

[csharp]  view plain copy
  1. //BMKActionPaopaoView.h  
  2. [BaseType (typeof(UIView))]  
  3. interface BMKActionPaopaoView  
  4. {  
  5.     /// <summary>  
  6.     /// [构造函数模式]  
  7.     /// 初始化并返回一个BMKActionPaopaoView  
  8.     /// - (id)initWithCustomView:(UIView*)customView;  
  9.     /// </summary>  
  10.     /// <param name="customView">Custom view.</param>  
  11.     [Export ("initWithCustomView:")]  
  12.     IntPtr Constructor (UIView customView);  
  13. }  


    1.打开StructsAndEnums.cs文件，如其名字一样这里是编写结构体和枚举的，也是最简单的一块：
      1）枚举（Enums）
     打开头文件[BMKAnnotationView.h]，可以看到原生代码：
[objc]  view plain copy
  1.    enum {  
  2.     BMKAnnotationViewDragStateNone = 0,      ///< 静止状态.  
  3.     BMKAnnotationViewDragStateStarting,      ///< 开始拖动  
  4.     BMKAnnotationViewDragStateDragging,      ///< 拖动中  
  5.     BMKAnnotationViewDragStateCanceling,     ///< 取消拖动  
  6.     BMKAnnotationViewDragStateEnding         ///< 拖动结束  
  7. };  
  8. typedef NSUInteger BMKAnnotationViewDragState;  
[csharp]  view plain copy
  1. public enum BMKAnnotationViewDragState  
  2. {  
  3.     None = 0,      ///< 静止状态.  
  4.     Starting,      ///< 开始拖动  
  5.     Dragging,      ///< 拖动中  
  6.     Canceling,     ///< 取消拖动  
  7.     Ending         ///< 拖动结束  
  8. }  
    简单的把有含义的单词提取出来，以方便在C#中使用，枚举无非就是使用整数0、1、2代表各实际含意。
     2）结构体（Structs）
    打开头文件[BMKType.h]，可以看到原生代码：
[objc]  view plain copy
  1. typedef struct {  
  2.     CLLocationCoordinate2D center;  ///< 中心点经纬度坐标  
  3.     BMKCoordinateSpan span;     ///< 经纬度范围  
  4. } BMKCoordinateRegion;  
[csharp]  view plain copy
  1. public struct BMKCoordinateSpan  
  2. {  
  3.     public double latitudeDelta;  
  4.     public double longitudeDelta;  
  5. }  
   2.Binding APIs
      打开ApiDefinition.cs，以下将开始对头文件中出现的原生语法类型进行介绍

      1）Binding Methods（基础方法）

[objc]  view plain copy
  1. - (void)setCoordinate:(CLLocationCoordinate2D)newCoordinate;  
  2. + (BMKArcline *)arclineWithPoints:(BMKMapPoint *)points;  
  3. + (BMKCircle *)circleWithCenterCoordinate:(CLLocationCoordinate2D)coord radius:(CLLocationDistance)radius;  
     C#代码， “+”代表静态方法，加Statice标识 ；当遇到不是基本数据类型时，例如[BMKCircle],可找着对应头文件，先进行其对象binding
[csharp]  view plain copy
  1. [Export ("setCoordinate:")]  
  2. void SetCoordinate (CLLocationCoordinate2D newCoordinate);  
  3.   
  4. [Static,Export ("arclineWithPoints:")]  
  5. BMKArcline ArclineWithPoints (BMKMapPoint points);  
  6.   
  7. [Static,Export ("circleWithCenterCoordinate:radius:")]  
  8. BMKCircle CircleWithCenterCoordinate (CLLocationCoordinate2D coord, double radius);  
        带out/ref parameters的方法
[objc]  view plain copy
  1. - (void) someting:(int) foo withError:(NSError **) retError;  
  2. - (void) someString:(NSObject **)byref;  
[csharp]  view plain copy
  1. [Export ("something:withError:")]  
  2. void Something (int foo, out NSError error);  
  3. [Export ("someString:")]  
  4. void SomeString (ref NSObject byref);  
2）Binding Properties（属性）

[objc]  view plain copy
  1. @property (nonatomic) CGPoint calloutOffset;  
  2. @property (nonatomic, getter=isSelected) BOOL selected;  
  3. @property (nonatomic, getter=isDraggable) BOOL draggable __OSX_AVAILABLE_STARTING(__MAC_NA,__IPHONE_3_2);  
  4. @property (nonatomic, retain) NSArray   *POIs;  
      C#代码，相关对应[Memory management attributes内存管理标识] ArgumentSemantic标识有三个：Assign，Copy，Retain ，依情况而定；与静态方法同样如果是带“+”，也要进行 [Static] 标识

[csharp]  view plain copy
  1. [Export ("calloutOffset")]  
  2. PointF CalloutOffset{ get; set; }  
  3.   
  4. [Export ("selected")]  
  5. bool Selected{ [Bind ("isSelected")]get; set; }  
  6.   
  7. [Export ("draggable")]  
  8. bool Draggable{ [Bind ("isDraggable")]get; set; }  
  9.   
  10. [Export ("POIs", ArgumentSemantic.Retain)]  
  11. NSArray POIs{ get; set; }  
     3）Binding Constructors（构造函数）
[objc]  view plain copy
  1. - (id)initWithCustomView:(UIView*)customView;  
C#对应，id可以理解为一个实例化对象
[csharp]  view plain copy
  1. [Export ("initWithCustomView:")]  
  2. IntPtr Constructor (UIView customView);  
     4）Binding Protocols（委托协议）
Protocol需要在interface对应头上添加 [Model][Protocol] ，以标明为Delegate
[objc]  view plain copy
  1. @protocol BMKLocationServiceDelegate <NSObject>  
  2. @optional  
  3. - (void)willStartLocatingUser;  
  4. - (void)didStopLocatingUser;  
  5. @end  
C#对应，@optional可选标识不用标识
[csharp]  view plain copy
  1. [Model][Protocol]  
  2. [BaseType (typeof(NSObject))]  
  3. interface BMKLocationServiceDelegate  
  4. {  
  5.     [Export ("willStartLocatingUser")]  
  6.     void willStartLocatingUser ();  
  7.   
  8.     [Export ("didStopLocatingUser")]  
  9.     void didStopLocatingUser ();  
  10. ｝  
而需要使用委托协议方法的对应类中，需要这样实现

[objc]  view plain copy
  1. @property (nonatomic, assign) id<BMKLocationServiceDelegate> delegate;  
C#对应，Assign与属性标识一致，根据实际添加
[csharp]  view plain copy
  1. [Export ("delegate", ArgumentSemantic.Assign)]  
  2. NSObject WeakDelegate { get; set; }  
  3.   
  4. [Wrap ("WeakDelegate")]  
  5. BMKLocationServiceDelegate Delegate { get; set; }  
     5）Binding Class Extensions

还未使用过：

[csharp]  view plain copy
  1. [BaseType (typeof (UIResponder))]  
  2. interface UIView {  
  3.         [Bind ("drawAtPoint:withFont:")]  
  4.         SizeF DrawString ([Target] string str, PointF point, UIFont font);  
  5. }  
      6）Binding Objective-C Argument Lists
[objc]  view plain copy
  1. - (void) appendWorkers:(XWorker *) firstWorker, ... NS_REQUIRES_NIL_TERMINATION ;  
[csharp]  view plain copy
  1. [Export ("appendWorkers"), Internal]  
  2. void AppendWorkers (Worker firstWorker, IntPtr workersPtr)  
     7）Binding Fields
Sometimes you will want to access public fields that were declared in a library.
还未使用过：
[csharp]  view plain copy
  1. [Field ("NSSomeEventNotification")]  
  2. NSString NSSomeEventNotification { get; }  
      8）Binding Notifications（通知）
还未使用过：
[csharp]  view plain copy
  1. interface MyClass {  
  2.     [Notification]  
  3.     [Field ("MyClassDidStartNotification")]  
  4.     NSString DidStartNotification { get; }  
  5. }  
      9）Binding Categories（类别）

这个百度地图上出现比较多，还有几个问题官网没提到的问题:

[objc]  view plain copy
  1. @interface BMKMapView (LocationViewAPI)  
  2. /// 问题出现在此  
  3. @property (nonatomic) BOOL showsUserLocation;  
  4.   
  5. -(void)updateLocationData:(BMKUserLocation*)userLocation;  
  6. @end  
[Category]标识声明；文档中只提到了对方法的解析，但没有对属性进行说明，如果就按之前对属性进行解析，编译时会报错cannot declare instance members in a static class(不能在静态类中声明实例成员)，语法上的错误，根据要对其进行改造，利用ObjC上get，set构造器的规则进行赋取值修改，这时showsUserLocation就可以用了

[csharp]  view plain copy
  1. [Category,BaseType (typeof(BMKMapView))]  
  2. public partial interface LocationViewAPI  
  3. {  
  4.     [Export ("setShowsUserLocation:")]  
  5.     void SetShowsUserLocation(bool isShow);  
  6.   
  7.     [Export ("updateLocationData:")]  
  8.     void UpdateLocationData (BMKUserLocation userLocation);  
  9. ｝  
      10）Binding Blocks（可理解为Action）

ObjC是为了避免Protocol的混乱而设计的

[objc]  view plain copy
  1. - (void)asyncInitWithSuccess:(void (^)())onSuccess failure:(void (^)(NSError *))onFailure;
[csharp]  view plain copy
  
  1. [Export ("asyncInitWithSuccess:failure:")]
  2. void AsyncInitWithSuccess (Action onSuccess, Action<NSError> onFailure); 
      11）Asynchronous Methods（异步方法）
这个api中也比较少见
[csharp]  view plain copy
  1. [Export ("loadfile:completed:")]  
  2. [Async]  
  3. void LoadFile (string file, Action<string> completed);  

     12）Binging [typedef] 

     使用typedef为现有类型创建同义字，定义易于记忆的类型名

[objc]  view plain copy
  1. typedef void(^ESTCompletionBlock)(NSError* error);  
  2. typedef void(^ESTUnsignedCompletionBlock)(unsigned value, NSError* error);  
  3. typedef void(^ESTBoolCompletionBlock)(BOOL value, NSError* error);  
  4. typedef void(^ESTStringCompletionBlock)(NSString* value, NSError* error);  
[csharp]  view plain copy
  1. public delegate void ESTCompletionBlock(NSError error);  
  2. public delegate void ESTUnsignedCompletionBlock(byte value, NSError error);  
  3. public delegate void ESTBoolCompletionBlock(bool value, NSError error);  
  4. public delegate void ESTStringCompletionBlock(NSString value, NSError error);  
   3.备注

     1）NSArray数组

由于ObjC中直接以NSObjce进行操作，因此有些时候并不知道NSArray的对象到底是何种数据类型，但如果在解析过程中，你很明确知道时，可以这样解析

[objc]  view plain copy
  1. - (NSArray *)getPeerViews ();  
  2. - (void) setViews:(NSArray *) views  
[csharp]  view plain copy
  1. [Export ("getPeerViews")]  
  2. UIView [] GetPeerViews ();  
  3.   
  4. [Export ("setViews:")]  
  5. void SetViews (UIView [] views);  
      2）NSString类型，可以直接使用string替换
      3）委托协议的使用

[objc]  view plain copy
  1. @interface Demo : NSObject <UIAlertViewDelegate>  
  2. @end  
[csharp]  view plain copy
  1. [BaseType (typeof (NSObject), KeepUntilRef="Dismiss"),   
  2. Delegates=new string [] { "WeakDelegate" }, Events=new Type [] { typeof (SomeDelegate) }) ]  
  3. class Demo {  
  4.     [Export ("show")]  
  5.     void Show (string message);  
  6. }  
      4）public partial的使用
在Binding Categories（类别）中，必须使用public partial [interface LocationViewAPI]标识，否则就无法成功调用。



参考链接： http://ipixels.net/blog/specify-extra-gcc-flags-for-native-library-binding-in-xamarin-ios/
http://www.aaronheise.com/2013/08/gooddynamicsmonotouch/

这篇关于Xamarin.iOS使用Objective-C静态类库.a(Linking Native Libraries)的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1086088。

相关文章

C语言中联合体union的使用

C语言中联合体union的使用

本文编辑整理自： http://bbs.chinaunix.net/forum.php?mod=viewthread&tid=179471 一、前言 “联合体”(union）与“结构体”(struct)有一些相似之处。但两者有本质上的不同。在结构体中,各成员有各自的内存空间, 一个结构变量的总长度是各成员长度之和。而在“联合”中,各成员共享一段内存空间, 一个联合变量
阅读更多...
Tolua使用笔记（上）

Tolua使用笔记（上）

目录   1.准备工作 2.运行例子 01.HelloWorld：在C#中，创建和销毁Lua虚拟机 和 简单调用。 02.ScriptsFromFile：在C#中，对一个lua文件的执行调用 03.CallLuaFunction：在C#中，对lua函数的操作 04.AccessingLuaVariables：在C#中，对lua变量的操作 05.LuaCoroutine：在Lua中，
阅读更多...
Vim使用基础篇

Vim使用基础篇

本文内容大部分来自 vimtutor，自带的教程的总结。在终端输入vimtutor 即可进入教程。 先总结一下，然后再分别介绍正常模式，插入模式，和可视模式三种模式下的命令。 目录 看完以后的汇总 1.正常模式（Normal模式） 1.移动光标 2.删除 3.【:】输入符 4.撤销 5.替换 6.重复命令【. ; ,】 7.复制粘贴 8.缩进 2.插入模式 INSERT
阅读更多...
Lipowerline5.0 雷达电力应用软件下载使用

Lipowerline5.0 雷达电力应用软件下载使用

1.配网数据处理分析 针对配网线路点云数据，优化了分类算法，支持杆塔、导线、交跨线、建筑物、地面点和其他线路的自动分类；一键生成危险点报告和交跨报告；还能生成点云数据采集航线和自主巡检航线。 获取软件安装包联系邮箱:2895356150@qq.com，资源源于网络，本介绍用于学习使用，如有侵权请您联系删除！ 2.新增快速版，简洁易上手 支持快速版和专业版切换使用，快速版界面简洁，保留主
阅读更多...
如何免费的去使用connectedpapers？

如何免费的去使用connectedpapers？

免费使用connectedpapers 1. 打开谷歌浏览器2. 按住ctrl+shift+N,进入无痕模式3. 不需要登录（也就是访客模式）4. 两次用完，关闭无痕模式（继续重复步骤 2 - 4） 1. 打开谷歌浏览器 2. 按住ctrl+shift+N,进入无痕模式 输入网址：https://www.connectedpapers.com/ 3. 不需要登录（也就是
阅读更多...
iOS HTTPS证书不受信任解决办法

iOS HTTPS证书不受信任解决办法

之前开发App的时候服务端使用的是自签名的证书，导致iOS开发过程中调用HTTPS接口时，证书不被信任 - (void)URLSession:(NSURLSession *)session didReceiveChallenge:(NSURLAuthenticationChallenge *)challenge completionHandler:(void (^)(NSURLSessionAu
阅读更多...
Toolbar+DrawerLayout使用详情结合网络各大神

Toolbar+DrawerLayout使用详情结合网络各大神

最近也想搞下toolbar+drawerlayout的使用。结合网络上各大神的杰作，我把大部分的内容效果都完成了遍。现在记录下各个功能效果的实现以及一些细节注意点。 这图弹出两个菜单内容都是仿QQ界面的选项。左边一个是drawerlayout的弹窗。右边是toolbar的popup弹窗。 开始实现步骤详情： 1.创建toolbar布局跟drawerlayout布局 <?xml vers
阅读更多...
C#中，decimal类型使用

C#中，decimal类型使用

在Microsoft SQL Server中numeric类型，在C#中使用的时候，需要用decimal类型与其对应，不能使用int等类型。 SQL：numeric C#：decimal
阅读更多...
探索Elastic Search：强大的开源搜索引擎，详解及使用

探索Elastic Search：强大的开源搜索引擎，详解及使用

🎬 鸽芷咕：个人主页  🔥 个人专栏: 《C++干货基地》《粉丝福利》 ⛺️生活的理想，就是为了理想的生活! 引入 全文搜索属于最常见的需求，开源的 Elasticsearch （以下简称 Elastic）是目前全文搜索引擎的首选，相信大家多多少少的都听说过它。它可以快速地储存、搜索和分析海量数据。就连维基百科、Stack Overflow、
阅读更多...
flask 中使用 装饰器

flask 中使用 装饰器

因为要完成毕业设计，我用到fountain code做数据恢复。 于是在github上下载了fountain code的python原代码。 github上的作者用flask做了fountain code的demo。 flask是面向python的一个网站框架。 里面有用到装饰器。 今天笔试的时候，我也被问到了python的装饰器。
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2