准备AndroidStudio工程
首先需要一个android studio工程,因为bgfx在安卓上只编译出库或提供源码,不会直接生成apk。
克隆google的native-activity工程并调试环境使其可打包apk。
1.build可能需要一个版本较新的android studio版本,不然可能在sync gradle时会提示相应错误。
2.需要修改Manifest.xml文件,位于项目/app/src/main/下,将android:hasCode="false"
删除或注释掉,否则build出来会报错崩溃。
build出来是一个一直变化颜色的程序。
安卓存储路径坑
这个问题主要是针对bgfx提供的example。
为了统一example的打开资源路径,使传入fopen的地址一致,bgfx生成vs工程会自动填写工作目录。
bgfx build时,不会将所需资源打入包中,因此github提到使用
adb push examples/runtime /sdcard/bgfx/examples/runtim
将所需资源拷贝到手机上,而安卓打包会在entry_android.cpp
的MainThreadEntry::threadFunc
方法中调用chdir
将工作目录设置为/sdcard/bgfx/examples/runtime
。Android11后,应用无法直接访问
/sdcard
下文件,只能使用/sdcard/Android/data/<package name>/files
下的文件,因此需要修改entry_android.cpp
以及拷贝目标路径。我的拷贝资源的命令为:
adb push examples/runtime /sdcard/Android/data/<package name>/files/bgfx/examples/runtime
。entry_android.cpp
的修改,我用jni获取外部存储路径:
const std::string GetExtStoragePath()//返回/sdcard/Android/data/<package name>/files
{
android_app* app = s_ctx.m_app;
ANativeActivity* activity = app->activity;
JNIEnv* env = nullptr;
(*activity->vm).AttachCurrentThread(&env, 0);
jclass clazz = env->GetObjectClass(activity->clazz);
jmethodID methodID = env->GetMethodID(clazz, "getExternalFilesDir", "(Ljava/lang/String;)Ljava/io/File;");
jobject file = env->CallObjectMethod(activity->clazz, methodID, NULL);
jclass fileClass = env->FindClass("java/io/File");
jmethodID getAbsolutePath = env->GetMethodID(fileClass, "getAbsolutePath", "()Ljava/lang/String;");
jobject result = env->CallObjectMethod(file, getAbsolutePath);
jboolean isCopy;
std::string res = env->GetStringUTFChars((jstring)result, &isCopy);
env->DeleteLocalRef(file);
env->DeleteLocalRef(result);
return res;
}
// in MainThreadEntry::threadFunc
//int32_t result = chdir("/sdcard/bgfx/examples/runtime"); //原始bgfx
//int32_t result = chdir("/sdcard/Android/data/com.example.native_activity/files/bgfx/examples/runtime"); //写死的方法
const std::string resPath = GetExtStoragePath() + "/bgfx/examples/runtime"; //jni动态获取,加上bgfx的目录层级
int32_t result = chdir(resPath.c_str());
已配置工程
native-activity-bgfx,需按照上述修改或readme进行简单修改,因为上述代码是在submodule中,无法提交。
如果需要build其他示例,只需改\app\src\main\Manifest.xml
中的:
<!-- Tell NativeActivity the name of our .so -->
<meta-data android:name="android.app.lib_name"
android:value="example-01-cubes" />
android:value
内容的修改,可以参照路径:app\build\intermediates\stripped_native_libs\debug\out\lib\armeabi-v7a
中.so的名字,去掉文件开头的lib和结尾的.so,然后填入即可(你必须先build一次才能有上述的文件夹)。
如果需要编译自己的示例,修改app\src\main\cpp\CMakeLists.txt
,将最下面的注释打开,会编译一个libnative-activity.so
,将这个按照上面的规则,填入android:value
即可。