如何开发Android原生库并应用到Xamarin.Android

本文将向大家介绍如何使用Android Studio开发原生库,并将其应用到Xamarin.Android的方法步骤;

本文中我所使用的Android Studio版本和Visual Studio For Mac版本情况分别如下:

Android Studio
Visual Studio For Mac

下述内容在以上两个版本的开发环境中是有效的。

Android Studio开发部分

首先,新建一个支持C++的Android Studio项目;

选中 include C++ support。
然后一路next,在add an Activity to Mobole处选择加入一个Empty Activity,这样会比较省事。

然后一路next,完成项目创建;

添加一个Java类,这里取名NativeTest;

内容如下:

package suihan.com.nativedemo;

public class NativeTest {

    static {
        System.loadLibrary("native-lib");
    }

    public static native String Test();
    
}

这里我将static { System.loadLibrary("native-lib"); }剪切到了这个类下,因为后面我们打包的JAR文件中并不包含自动生成的MainActivity类,如果这段代码依然留在这个类中会到os文件没有加载。当然具体的加载时机,你可以自行修改。

利用Android Studio的智能修复功能,就可以生成对应的native方法。我将代码补全成如下模样:

#include <jni.h>
#include <string>

extern "C" JNIEXPORT jstring

JNICALL
Java_suihan_com_nativedemo_MainActivity_stringFromJNI(
        JNIEnv *env,
        jobject /* this */) {
    std::string hello = "Hello from C++";
    return env->NewStringUTF(hello.c_str());
}
extern "C"
JNIEXPORT jstring JNICALL
Java_suihan_com_nativedemo_NativeTest_Test(JNIEnv *env, jclass type) {
    // TODO
    std::string test = "Test Native";
    return env->NewStringUTF(test.c_str());
}

这个时候,rebuild project就可以在app/build/intermediates/cmake/debug文件夹下看到生成的so文件;


然后我们需要打包成Jar文件。我们需要修改一下app的build.gradle文件。需要修改的地方如下:

  1. 将apply plugin: 'com.android.application'该成apply plugin: 'com.android.library';
  2. 注释掉 applicationId 项;
  3. 添加如下代码:
task makeJar(type: Copy) {
    //删除存在的
    delete 'build/libs/myNativeSdk.jar'
    //设置拷贝的文件
    from('build/intermediates/packaged-classes/release/')
    //打进jar包后的文件目录
    into('build/libs/')
    //将classes.jar放入build/libs/目录下
    //include ,exclude参数来设置过滤
    //(我们只关心classes.jar这个文件)
    include('classes.jar')
    //重命名
    rename ('classes.jar', 'myNativeSdk.jar')
}
makeJar.dependsOn(build)

最后的build.gradle文件内容是这样的:

apply plugin: 'com.android.library'

android {
    compileSdkVersion 28
    defaultConfig {
        //applicationId "suihan.com.nativedemo"
        minSdkVersion 14
        targetSdkVersion 28
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
        externalNativeBuild {
            cmake {
                cppFlags ""
            }
        }
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
    externalNativeBuild {
        cmake {
            path "CMakeLists.txt"
        }
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'com.android.support:appcompat-v7:28.0.0-rc02'
    implementation 'com.android.support.constraint:constraint-layout:1.1.3'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'com.android.support.test:runner:1.0.2'
    androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}
task makeJar(type: Copy) {
    //删除存在的
    delete 'build/libs/myNativeSdk.jar'
    //设置拷贝的文件
    from('build/intermediates/packaged-classes/release/')
    //打进jar包后的文件目录
    into('build/libs/')
    //将classes.jar放入build/libs/目录下
    //include ,exclude参数来设置过滤
    //(我们只关心classes.jar这个文件)
    include('classes.jar')
    //重命名
    rename ('classes.jar', 'myNativeSdk.jar')
}
makeJar.dependsOn(build)

注意:build/intermediates/packaged-classes/release/路径是在Android Studio 3之后才是这样,如果是Android studio 2的话,应该是build/intermediates/bundles/default/,更早的版本也和这个路径不一样,具体的请自行搜索;

这个时候我们最好删除掉之前编译出来的build文件夹,在Terminal中输入命令行:./gradlew makeJar

然后,我们在app/build路径下就可以看到libs/myNativeSdk.jar,


好,现在原生库需要的文件已经准备完毕。

Xamarin.Android开发部分

1.新建一个Bindings Library项目;

在NativeBindingLib项目的Jars中加入前面我们生成的myNativeSdk.jar文件;


添加时最好是以链接的方式添加,这样一来,我们修改原生库的时候就不需要重新添加文件了,只要重新编译一下这个项目就可以了。


编译Binding项目后,在NativeTest项目中添加对他的引用。

下面我们添加so文件,这里我们在NativeTest项目新建一个lib文件夹,并在里面新建如下这几个文件夹,分别对应前面生成的4中架构的so文件,并将对应的so文件添加到其中,添加时注意同前面一样以链接的方式添加。

我们需要将每一个so文件的Build Action改为AndroidNativeLibrary;

然后通过reveal in Find功能打开NativeTest项目所在的文件夹,对该项目的.csproj文件进行编辑,打开后找到每一个so文件的添加配置,在配置中加入对应的<Abi>属性;

修改MainActivity文件的内容,以调用原生接口:

using Android.App;
using Android.Widget;
using Android.OS;
using Suihan.Com.Nativedemo;

namespace NativeTest {
    [Activity(Label = "NativeTest", MainLauncher = true, Icon = "@mipmap/icon")]
    public class MainActivity : Activity {
        int count = 1;

        protected override void OnCreate(Bundle savedInstanceState) {
            base.OnCreate(savedInstanceState);

            // Set our view from the "main" layout resource
            SetContentView(Resource.Layout.Main);

            // Get our button from the layout resource,
            // and attach an event to it
            Button button = FindViewById<Button>(Resource.Id.myButton);

            button.Text = Suihan.Com.Nativedemo.NativeTest.Test();

            //button.Click += delegate { button.Text = $"{count++} clicks!"; };
        }
    }
}

完成这一系列配置后,运行项目,可见如下效果:

真机的效果,调用arm64-v8a架构
虚拟机的效果,调用x86架构

至此我们已经完成了对原生库的应用。

调试原生库时的注意事项

后面我们可能会需要对原生库进行修改,为了节省调试时间,我们最好是在原生环境下将代码调试好。这个时候我们需要把app的build.gradle文件修改回来。

  1. 将apply plugin: 'com.android.library'恢复为 apply plugin: 'com.android.application';
  2. 恢复 applicationId 项;

然后就可以运行程序了。

调试好代码后,要生成jar时,我们还是需要将build.gradle文件修改回去。

生成新的jar后,我们只需要重新编译一下Xamarin中的项目即可。

参考文献

Android Studio生成so文件的几种方式
Android studio3.1.3 打包jar,混淆
Using Native Libraries

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,015评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,262评论 1 292
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,727评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,986评论 0 205
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,363评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,610评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,871评论 2 312
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,582评论 0 198
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,297评论 1 242
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,551评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,053评论 1 260
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,385评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,035评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,079评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,841评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,648评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,550评论 2 270

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 170,569评论 25 707
  • 用两张图告诉你,为什么你的 App 会卡顿? - Android - 掘金 Cover 有什么料? 从这篇文章中你...
    hw1212阅读 12,473评论 2 59
  • 我要非常感谢您对我来德的事帮助和支持。我也知道这么短的时间的准备是不够的,所以我完全理解你们的情况。 您邀请我和你...
    tuka_阅读 140评论 0 0
  • 引 子: 前天晚上接到小师妹的电话,电话那头传来特别有感染力的声音:“哎呀!石娜,恭喜你啦,你带的南宁分舵终于修成...
    石娜阅读 759评论 11 5
  • 提取requests响应中的头部信息:
    Natsuka阅读 960评论 0 0