awtk/docs/how_to_use_3rd_libs.md

如何引用第三方库

使用第三方库时，在应用程序的 SConstruct 中描述依赖关系即可。具体方式为：先定义依赖描述，再调用 set_deps 将依赖描述设置到 helper 里。

示例：

DEPENDS_LIBS = [
  {
    "root" : '../awtk-mvvm',
    'shared_libs': ['mvvm'],
    'static_libs': []
  },  
  {
    "root" : '../awtk-restful-httpd',
    'shared_libs': ['httpd'],
    'static_libs': []
  }
]

helper.set_deps(DEPENDS_LIBS)

注意：helper.set_deps 一定要在 helper.call 之前调用。

依赖描述内容

• root 第三方库的根目录。建议使用相对于应用程序的相对路径。

如：

  "root" : '../awtk-mvvm',

• shared_libs 第三方库提供的共享库列表（数组），不带扩展名和 lib 前缀。

如：

"shared_libs" : ["a","b","c"]

• static_libs 第三方库提供的静态库库列表（数组），不带扩展名和 lib 前缀。

如：

"static_libs" : ["a","b","c"]

• libpath 库所在的路径，相对于前面指定的 root 路径。缺省为：["lib", "bin"]

如：

"libpath" : ["libs", "bin"]

• cpppath 头文件所在的路径，相对于前面指定的 root 路径。缺省为：["src"]

如：

"cpppath" : ["includes", "src"]

• cflags C 语言的 flags 定义（可选）。

如：

"cflags" : " -DNDEBUG=1 "

• cxxflags C++语言的 flags 定义（可选）。

• ccflags C/C++语言的 flags 定义（可选）。

完整示例

• awtk-mvvm-c-hello