Ubuntu 16.04系统下Linux新手如何用C语言调用第三方API

Hey Sara, no worries—this is super common when you're starting out with Linux C development! Let's break down exactly what you need to do step by step to call that third-party API:

First, you need to make sure your C code can access the function prototypes and macros from the provided .h file:

• Option 1 (Simplest for beginners): Place the .h file directly in your project directory (same folder as your .c source code). Then include it in your code like this:

  #include "thirdparty.h" // Use quotes for local headers, not angle brackets
  

• Option 2: If you want to keep headers organized in a subfolder (like ./includes/), you'll need to tell the compiler where to look for it using the -I flag during compilation (we'll cover the full compile command later).

The .so file is the compiled library containing the actual API implementation—you need to link your code against it to use those functions. Here's how:

• First, note the library name: if the file is libthirdparty.so, the "short name" you'll use is thirdparty (drop the lib prefix and .so suffix).
• When compiling, use two flags:
  • -L/path/to/so/file: Tells the linker where to find the .so file (replace with the actual path, e.g., -L./ if it's in your project folder).
  • -lthirdparty: Tells the linker to link against the library (using that short name we just mentioned).

Let's say your setup is:

• Source code: main.c (with the API calls)
• Header file: thirdparty.h (in the same folder)
• Shared library: libthirdparty.so (in the same folder)

Your compile command would look like this:

gcc main.c -I./ -L./ -lthirdparty -o my_program

Let's break down each part:

• gcc main.c: Compiles your source code
• -I./: Includes the current directory in the header search path
• -L./: Includes the current directory in the library search path
• -lthirdparty: Links against libthirdparty.so
• -o my_program: Names the final executable my_program

After compiling, if you try to run ./my_program and get an error like error while loading shared libraries: libthirdparty.so: cannot open shared object file, it's because the system can't find the .so file at runtime. Fix this with one of these methods:

• Temporary fix (good for testing): Set the LD_LIBRARY_PATH environment variable to include the folder with your .so file:

  export LD_LIBRARY_PATH=./:$LD_LIBRARY_PATH
  ./my_program
  

• Permanent fix for your project: Add the -Wl,-rpath=./ flag to your compile command. This embeds the library path directly into the executable, so you don't need to set the environment variable every time:

  gcc main.c -I./ -L./ -lthirdparty -Wl,-rpath=./ -o my_program
  

• System-wide fix: If you want this library available to all programs, copy libthirdparty.so to /usr/lib/ or /usr/local/lib/ (you'll need sudo for this).

Here's a simple snippet to show how it all comes together:

#include <stdio.h>
#include "thirdparty.h"

int main() {
    // Replace this with an actual API function from the third-party library
    int api_result = thirdparty_process_data(123);
    printf("API call returned: %d\n", api_result);
    return 0;
}

If you run into specific errors (like undefined references or missing headers), feel free to share the exact messages—we can troubleshoot further!

内容的提问来源于stack exchange，提问作者Sara M