Detect and use optional external C library at runtime in Objective-C

Question 1

Use dlsym to get the C function pointers by function name. If it can find them, they're there. Otherwise they're not. Just use RTLD_DEFAULT as the first parameter.

EDIT: having cast around for an iOS example, see Mike Ash's write up of PLWeakCompatibility, particularly the section on 'Falling Through'. You'll see he checks whether objc_loadWeakRetained (a runtime call related to weak references) is present. Under 5+ it is and his version calls the real one directly. Under 4 it isn't so his version does something else instead.

EDIT2: sample code:

Sample 1:

#import <Foundation/Foundation.h>
#include <dlfcn.h>

int main(int argc, char *argv[]) 
{
    @autoreleasepool
    {
        NSLog(@"%p", dlsym(RTLD_DEFAULT, "someFunc"));
    }
}

Outputs 0x0. Sample 2:

#import <Foundation/Foundation.h>
#include <dlfcn.h>

void someFunc()
{

}

int main(int argc, char *argv[])
{
    @autoreleasepool
    {
        NSLog(@"%p", dlsym(RTLD_DEFAULT, "someFunc"));
    }
}

Outputs an address other than 0x0.

Sample 3:

#import <Foundation/Foundation.h>
#include <dlfcn.h>

void someFunc()
{
    NSLog(@"Hi!");
}

int main(int argc, char *argv[])
{
    @autoreleasepool
    {
        void (* func)();
        func = dlsym(RTLD_DEFAULT, "someFunc");
        func();
    }
}

Outputs Hi!.

Structs have no presence in a .a or elsewhere at runtime, they're just instructions to the compiler on how to format data. So you'll need to include either the actual structs or a compatible restatement of them in your code.

Question 2

You can do it using weak functions. In your static library, declare all function of ccc that you want to use like this:

int cccfunction(void) __attribute__((weak));

Don't include ccc in you lib. Since the functions are declared as weak, the compiler wouldn't complain about their absence, however you will be able to reference it in you code. Then, when you distribute the library to your users, give them a .c file with empty ccc functions inside, returning 0/null. This is necessary when the ccc lib is not available.
The user must delete this file if the CCC library is imported.

LOOK at this project

execute IOSLibraries and look at the log. At the first execution, you will see in the log

CCC not found   <--- this line is printed by libstatic (your library)

if you go in the optional.c file and comment the cccfunction(), you will see in the log

Executing a function of CCC  <--- this line is printed by libccc
CCC has been found and the function has been executed  <--- this line is printed by libstatic (your library)

If you remove both the ccc lib and the optional.c file you will see

Undefined symbols for architecture xxxxxx: "_cccfunction", referenced from: _wrapper_cccfunction in libstaticfirst_universal.a(wrapper_cccfunction.o)

This is the reason why you need to ship the optional.c file, so the user compiler won't complain about not found methods. When the user has the CCC lib, he can simply delete or comment the optional.c file. In your library you will be able to test for the presence of the CCC library looking at the return value of some control functions

EDIT - old answer: after realizing that you are on iOS, the below (and first) answer became not valid. Dynamic linking works only on OSX. However, I leave the old answer for persons using OSX

OLD ANSWER
I think that

I assume that CCC is a static library (if it's dynamic it's simpler). In this case, AFAIK, you can do nothing "automagically", but a good compromise can be something like this, using Dynamic libraries

user project --include--> your static library --include--> a dynamic library --can include–-> the CCC library

create two version of the dynamic library:

one that implements, for example, empty functions of the CCC library -> when you call the function, they returns 0/null and you know that the library is not implemented. You can even use something smarter (a simple control function)
give to the users the source code of a second dynamic library, that they can compile simply by doing drag-drop of the CCC library inside the project, and then moving the compiled library in the right place. This is not the source code of your library (your code is compiled in the static part), but only the code of the wrapper functions that you call from your static libraries.
your static library don't call directly functions of the CCC library, but only wrapper functions that always exists (in both the "empty dynamic library" and in the "compiled-by-user dynamic library")

By doing this, the user can replace the "empty" dynamic library with the one that include CCC. If the dynamic library is the one with the CCC linked, the final project will use the function of CCC, otherwise it won't.

Look at the attached example:

LibTests project implements the lib libstaticlib.a and call its function "usedynamic(int)"
libstaticlib.a implements the dynamic library libdynamic1 and call its function "firstfunction(int)"
libdynamic1 has two different copies: one has a firstfunction() that returns the number passed, the other returns the number*2

now, open LibTests (that should be project of your user), copy the first of the two compiled dynamic libraries in /usr/local/lib/ , then execute LibTests: you will see "10" in the console. Now, change the dynamic library with the second, and you will see "20".

This is what the user have to do: you sell the library with a dynamic "empty" component. If the user has bought CCC, you give instruction and code on how to compile the dynamic component with CCC bundled with it. After the dynamic library has been built, the user has simply to switch the .dylib file

Question 3

This is tricky, but manageable. If you only needed Objective-C classes from CCC, this would be easier, but you specifically said you need access to structs/functions.

Build a proxy class around all the CCC functionality. All CCC functionality must be encapsulated into instance methods of the proxy. All CCC types must be adapted into your own types. No part of CCC can be included in the anything outside the proxy class's implementation file. I will call this class MyCCCProxy.
Never directly reference the MyCCCProxy class object. More on this later.
Build your library without linking MyCCCProxy.m
Build a second static library with only MyCCCProxy.
Customers who have CCC will need to link AAA, CCC, and CCCProxy. Customers who don't have CCC will only link AAA.

The tricky step is number 2.

Most of the time when you create an instance of a class, you use:

MyCCCProxy *aCCCProxy = [[MyCCCProxy alloc] init];

This directly references the class object for MyCCCProxy and will cause user linking issues if MyCCCProxy is not included.

Instead, if you instead write:

MyCCCProxy *aCCCProxy = [[NSClassFromString(@"MyCCCProxy") alloc] init];

This does not directly reference the class object, it loads the class object dynamically. If MyCCCProxy does not exist as a class, then NSClassFromString returns Nil (the class version of nil). [Nil alloc] returns nil. [nil init] returns nil.

MyCCCProxy *aCCCProxy = [[NSClassFromString(@"MyCCCProxy") alloc] init];
if (aCCCProxy != nil) {
    // I have access to CCC through MyCCCProxy.
}

Question 4

so Here is the gist of your problem...

a static library can't be swapped by your own process... that is at link time I linked against libfoo.1.a now at run time this process can't reliably swap in the symbols for libfoo.2.a

so you need to get around this limitation.

the simplest is to use a dynamic library and the dynamic linker... but you are using iOS so you don't have access to that.

if you could run a helper you could possibly change the actual objects in the first process, but you are on iOS and that won't work...

so that leaves trying to make an object modify its own contents... which code signing won't let you do...

so that leaves building an overflow into your program and trying to get it to execute :)

actually it is much simpler than that...

make a buffer
fill it with code fragment
set uo stack frame (requires a little asm)
set up arguments for the function you plan to call
run buffer + offset to your method
profit

as a side note I wrote a little thing that demonstrates dynamic binding at run time... but you need to have a compiler etc... this strategy won't work on iOS

https://github.com/gradyplayer/cfeedback

EDIT I actually re-read your problem, and it is a much easier one that I thought you were trying to solve...

you can use whatever is #def'ed by the other headers to do conditional compilation... and if there are places where you have to include one of these structs into an object you can just typedef the struct then only use pointers to it, as long as the library has construction and destruction functions.

Question 5

It is not exactly runtime, but may solve your problem depending on CCC license.

Option 1 (compile time)

Create a CCC_wrap library with #ifdef, and give the instructions to compile it with and without the CCC_library.

For each CCC_function, you must have a equivalent CCC_function_wrap

If HAVE_CCC == 1 the wrapper function should call CCC library, otherwise, do nothing or return error.

Create an extra function to discover how your library was compiled

int CCC_wrap_isfake(void) {
#if HAVE_CCC
    return 0;
#else
    return 1;
#endif
}

Option 2 (binary ready)

Create two new libraries, CCC_wrap and CCC_wrap_fake

Both libraries must contain all functions/classes needed to run the program, but the fake library all functions will do nothing, just return 0;

Than you create a extra function CCC_wrap_isfake

CCC_wrap_fake:

int CCC_wrap_isfake(void) { return 1;}

CCC_wrap:

int CCC_wrap_isfake(void) { return 0;}

Now you know if your code is running with the real wrap, or the fake one.

On compile time, you need to set a flag to determine how your library will be linked to your client software

CCC_wrap_fake:

LDFLGAS=-lCCC_wrap_fake

CCC_wrap:

LDFLGAS=-lCCC_wrap -lCCC

Both options should link correctly.

About license requirement

If you deliver the CCC_wrap library source, your client will be able to update the CCC library, without having any access to you main source.

In both cases, it will not be required to you to ship the CCC library together with your source code.

Question 6

Your problem is more easly solved at compile time since your clients are already required to link everything by themselves.

Since your client is supposed to statically link all your "AAA" code together with "CCC" code, your problem can be solved by instructing your client to compile together "AAA.a" either with "AAA_with_CCC_glue.a" if they have "CCC.a" or "AAA_without_CCC_glue.a" if they don't. Both _glue.a would implement the set of functions that potentially uses CCC.a, difference is if they actually use it.

To solve this at runtime, you'd need at least to be able to call dlsym() (this post made me think that yes, you can, but it is old). Try that to look for all CCC.a functions that you care inside your app own memory.