Declaring iOS Libraries

In iOS, libraries can be provided as frameworks or static libraries.

Frameworks

Frameworks can be declared in the URS with the tag <specific><ios><library>.

They can refer to third party libraries that must be declared with:

  • path attribute: relative (to the project) or absolute path of the framework
  • system attribute: iOS system framework available by default in Xcode (like UIKit.framewort or Foundation.framework for the most known)

System library name can be chosen among a defined list under the system attribute.

<specific>
   <ios>
      <!-- iOS third party framework -->
      <library status="optional" path="lib/myLibrary.framework" />

      <!-- iOS system framework -->
      <library status="required" system="Accelerate.framework" />

   </ios>
</specific>

Note

iOS libraries have a status attribute to indicate if the library is optional or required. By default it is set to optional.

Static Libraries

Static libraries can be declared with the tag <specific><ios><staticlib>.

A static library often comes along with a set of header files. In that case, they must be referenced with the headersFolder attribute where the value is the path (absolute or relative to the project) of the folder.

Example

<specific>
   <ios>

      <!-- iOS static library -->
      <staticlib headersFolder="lib/myHeaderFolder" path="lib/myStaticLib.a"/>

   </ios>
</specific>

Note

iOS libraries have a status attribute to indicate if the library is optional or required. By default it is set to optional.