17

I downloaded TouchDB, a "lightweight Apache CouchDB-compatible database engine suitable for embedding into mobile or desktop apps", which gives me a bunch of .framework folders (CouchCocoa.framework, TouchDB.framework and TouchDBListener.framework).

I've been reading the article on binding Obj-C libraries to MonoTouch, it shows how to bind a .a, but not how to bind a .framework.

How do I make a binding for these .framework? or should I somehow make a .a of these .framework before using them (if that is even possible)?

--EDIT--

related : https://bitbucket.org/LouisBoux/touchdb-monotouchbinding

Louis Boux
  • 1,228
  • 1
  • 12
  • 26

2 Answers2

27

Bind a .framework in MonoTouch takes several steps, a .framework is a directory that usually houses all the parts of a library package (e.g., the header files, resources and the library file). Here are the general steps needed to bind a .framework.

  • Create a bindings project like you would for a normal library file (libXXX.a)

  • The library equivalent in a .framework is the file without the extension that is at the root of the .framework directory, for example I recently wrote bindings for RDPDFKit.framework, the top level file was a file named RDPDFKit (no extension), rename this to "libRDPDFKit.a" and copy to your bindings project and add it to the project. It will create a code behind file with the supported platforms (e.g., x86, arm6, etc). All the documentation for this is on Xamarin's web site.

  • Define the bindings as you would for a normal library.

  • If the framework has a .bundle, copy this to you Program project (not the bindings project), it will need to be added as resources for the program. Add this directory to the project and all the items underneath, this is because resources in monotouch are not supported in DLLs.

  • The resulting monotouch bindings DLL will contain the entire .a file for later linking so you won't need the .a file after building the .dll.

Kenny
  • 805
  • 8
  • 19
  • Is it normal nothing is generated in the code behind file platform wise? It only says LinkWith, SmartLink, Forceload but nothing regarding targets. –  Jul 26 '16 at 21:38
3

You can use the .framework files just like the .a files. E.g. all the bindings MonoTouch provides (in monotouch.dll) are made from .framework files.

poupou
  • 43,413
  • 6
  • 77
  • 174
  • Ok, but is there a way to have some kind of [LinkWith] (like with .a files) with a .framework, so I don't have to do the linking manually with the mtouch arguments? – Louis Boux May 14 '12 at 17:16
  • I have not used it with `[LinkWith]` but there's a bug report about it @ https://bugzilla.xamarin.com/show_bug.cgi?id=2530 – poupou May 14 '12 at 18:48
  • The .framework is a directory, .a file is a library. So really no correlation. – Kenny Oct 25 '12 at 13:37