java - 如何在 Java Android Studio 项目中使用 .so 共享库

Question

过去几天我一直在解决这个问题。我正在尝试使用 live555 ( http://www.live555.com/ )，一个 C/C++ 流媒体服务器，作为 Java Android Studio 项目中的库。我已经能够使用 ndk-build 创建一组 .so 文件，但是我找不到任何关于现在如何在我的 Java 应用程序中使用该库的文档。这是我的设置:

Windows 8.1 64 位

Oracle JDK 1.8

Android Studio 1.5.1

Gradle 1.5.0

构建工具 23.0.2

到目前为止我所采取的步骤:

使用 Android Studio 创建一个标准的 Android 应用程序。

右键单击项目资源管理器中的应用程序模块，然后选择新建 |文件夹 |上下文菜单中的 JNI 文件夹。

从 http://www.live555.com/liveMedia/public/ 下载 live555 源选择 live555-latest.tar.gz 文件。

将源文件解压到 JNI 文件夹，这样您现在就拥有一个文件夹结构，如:$PROJECT_DIR|--app|--|--src|--|--|--main|--|--|-- |--jni|--|--|--|--|--live 其中 live 文件夹包含 live555 源。

内jni文件夹，创建 Android.mk和 Application.mk文件。 Application.mk文件包含:

APP_OPTM := release
APP_ABI := armeabi armeabi-v7a
APP_PLATFORM := android-21
APP_STL := stlport_shared

Android.mk文件包含:

LOCAL_PATH := $(call my-dir)

include $(CLEAR_VARS)

LOCAL_MODULE := live555

LOCAL_SRC_FILES := \
live\BasicUsageEnvironment\BasicHashTable.cpp                \
live\BasicUsageEnvironment\BasicTaskScheduler0.cpp           \
...All of the rest of the .c and .cpp files

LOCAL_C_INCLUDES := \
    $(LOCAL_PATH)\live \
    $(LOCAL_PATH)\live\BasicUsageEnvironment\include \
    $(LOCAL_PATH)\live\BasicUsageEnvironment \
    $(LOCAL_PATH)\live\UsageEnvironment\include \
    $(LOCAL_PATH)\live\UsageEnvironment \
    $(LOCAL_PATH)\live\groupsock\include \
    $(LOCAL_PATH)\live\groupsock \
    $(LOCAL_PATH)\live\liveMedia\include \
    $(LOCAL_PATH)\live\liveMedia \

LOCAL_CPPFLAGS += -fPIC -fexceptions -DXLOCALE_NOT_USED=1 -DNULL=0 -DNO_SSTREAM=1 -UIP_ADD_SOURCE_MEMBERSHIP

include $(BUILD_SHARED_LIBRARY)

在我的 $PROJECT_DIR\gradle.properties文件，我已经包含了行 android.useDeprecatedNdk=true

在 $PROJECT_DIR\local.properties ， 我有:

ndk.dir=C\:\\Users\\user\\AppData\\Local\\Android\\ndk
sdk.dir=C\:\\Users\\user\\AppData\\Local\\Android\\sdk

在我的 $PROJECT_DIR\app\build.gradle我有文件:

apply plugin: 'com.android.application'

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.2"

    defaultConfig {
        applicationId "com.company.android.myapp"
        minSdkVersion 21
        targetSdkVersion 23
        versionCode 1
        versionName "1.0"

        ndk {
            moduleName "live555"
        }

        sourceSets.main {
            jni.srcDirs = []
            jniLibs.srcDir "src\\main\\libs"
        }
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:23.1.1'
}

然后我运行 ndk-build在 $PROJECT_DIR\app\src\main\jni文件夹。

ndk-build命令导致以下文件夹结构/文件输出:$PROJECT_DIR|--app|--|--src|--|--|--main|--|--|--|--libs|-- |--|--|--|--armeabi|--|--|--|--|--|--liblive555.so|--|--|--|--|--| --libSTLport_shared.so|--|--|--|--|--armeabi-v7a|--|--|--|--|--|--liblive555.so|--|-- |--|--|--|--libSTLport_shared.so|--|--|--|--obj|--|--|--|--|--local|--|-- |--|--|--|--armeabi|--|--|--|--|--|--|--objs|--|--|--|--|-- |--|--liblive555.so|--|--|--|--|--|--|--libSTLport_shared.so|--|--|--|--|--|- -armeabi-v7a|--|--|--|--|--|--|--objs|--|--|--|--|--|--|--liblive555.so |--|--|--|--|--|--|--libSTLport_shared.so

当我从 Build | 构建项目时制作项目菜单选项，我在 Android View 中有一个项目结构，如下所示:
app|--manifests|--java|--jniLibs|--|--armeabi|--|--|--liblive555.so|--|--|--libSTLport_shared.so|--|-- armeabi-v7a|--|--|--liblive555.so|--|--|--libSTLport_shared.so|--res

我在我的项目中添加了一个 Live555Ndk.java 文件，从中开始引用 live555 库。它包含了:

package com.company.android.myapp;

public class Live555Ndk {

    static {
        System.loadLibrary("live555");
    }

}

但是，现在我有了共享对象，我不知道如何开始在 live555 库上创建对象实例和调用方法。任何人都可以指出我正确的方向吗？

感谢您的任何见解。

更新 02/15/2016

好的，我已经删除了 ndk {}根据 mcwise 的以下建议，阻止我的 app\build.gradle 文件。

我想我现在已经想好了它是如何工作的，但我仍然无法引用 live555 库。我使用单个 Activity 和相应的布局文件启动了一个新的 Android 项目。我加了一个 jniLibs文件夹并将 armeabi\liblive555.so 等文件复制到该文件夹​​中。我在之前提到的 Live555Ndk.java 文件中添加了静态构造函数并调用了 SystemloadLibrary("live555"); .我还加了一个电话给 public native boolean isThisMediaSession(); .然后我使用 javah 在 jni 中生成了一个头文件文件夹。然后我创建了相应的 .cpp 文件来创建方法实现。但是，我不能包含 liblive555.so 中的任何头文件。就像 Android Studio 甚至不知道 live555 库的存在一样。所以，我不能有像 #include <live555/MediaSession.hh> 这样的线路。 .我错过了一个额外的步骤吗？这个 Android 项目只有 .so 文件，没有源文件。我是否需要将 live555 源添加到 jni文件夹？

Answer 1

查看由 Google 开发的许多 Android NDK 示例。您可以找到它们 here .

hello-gl2示例是一个很好的起点。

gl_code.cpp向您展示如何创建可从 Java 调用的 JNI 代码。特别注意这部分代码，它定义了两个方法并使它们对 Java 层可见:

extern "C" {
  JNIEXPORT void JNICALL Java_com_android_gl2jni_GL2JNILib_init(JNIEnv * env,
    jobject obj,  jint width, jint height);
  JNIEXPORT void JNICALL Java_com_android_gl2jni_GL2JNILib_step(JNIEnv * env, 
    jobject obj);
};

JNIEXPORT void JNICALL Java_com_android_gl2jni_GL2JNILib_init(JNIEnv * env, jobject obj,  jint width, jint height)
{
  setupGraphics(width, height);
}

JNIEXPORT void JNICALL Java_com_android_gl2jni_GL2JNILib_step(JNIEnv * env, jobject obj)
{
  renderFrame();
}

GL2JNILib.java向您展示如何从 Java 调用 gl_code.cpp 中定义的方法。

public class GL2JNILib {

  static {
    System.loadLibrary("gl2jni");
   }

  /**
   * @param width the current view width
   * @param height the current view height
   */
   public static native void init(int width, int height);
   public static native void step();
}

更新:

要构建依赖于 live555 库的 C++ 模块，您需要将以下部分添加到 Android.mk:

include $(CLEAR_VARS)
LOCAL_MODULE := your_module
LOCAL_SRC_FILES := your_module_file.cpp
LOCAL_SHARED_LIBRARIES := live555
include $(BUILD_SHARED_LIBRARY)

请参阅此文档以供引用:

Android.mk (LOCAL_SHARED_LIBRARIES)

Using prebuilt libraries (syntax is the same for downstream modules)