如何使用 Gradle 将资源（图像、声音文件、着色器等）添加到 NDK 项目？

Posted 2023-05-06

【中文标题】如何使用 Gradle 将资源（图像、声音文件、着色器等）添加到 NDK 项目？

【英文标题】：How can I add resources (images, sound files, shaders, etc...) to an NDK project with Gradle?

【发布时间】：2020-12-07 19:45:43

【问题描述】：

在这个代码库的 PC 版本中，我只是有以下目录结构：

 - myApp.exe
 - resources
 - - images
 - - - blah0.png
 - - - blah1.png
 - - shaders
 - - - blahA.spv
 - - - blahB.spv

因此，例如，从我的 C++ 代码中，我可以简单地请求 fopen("resources/images/blah0.png",...)。

对于 android，它似乎需要

#include <android/native_activity.h>
...
AAsset* file = AAssetManager_open(aassman, "resources/images/blah0.png", AASSET_MODE_STREAMING);
size_t len = AAsset_getRemainingLength64(file);
char *buff = malloc(len);
size_t read = AAsset_read(file, buff, len);
AAsset_close(file);

不幸的是，file 即将出现 nullptr，可能是因为它找不到该资源树。

我的 build.gradle 脚本有以下 sn-p：

  sourceSets 
    main 
      manifest.srcFile 'AndroidManifest.xml'
      assets.srcDirs 'build/cmake/release/arm64-v8a/resources'
    
  

^ 指向此列表顶部列出的同一资源目录。

---

我需要做些什么来确保将上述资源层次结构简单地传输到我的 .apk 中，以便可以通过上面的AAssetManager sn-p 访问它？

---

一些额外的实验：

我把assets.srcDirs的路径改成了some/random/path/on/my/hd，然后跑了

  AAssetDir *rootAssets = AAssetManager_openDir(aassman, "");
  const char *f = AAssetDir_getNextFileName(rootAssets);
  while(f)
  
    print(f);
    f = AAssetDir_getNextFileName(rootAssets);
  
  AAssetDir_close(rootAssets);

简单地枚举在顶层目录中找到的文件。我注意到它枚举了some/random/path/on/my/hd 中的所有文件，但没有一个目录。 （当我将它指向我的 resources 文件夹时，它什么也不枚举）。我不知道这是因为AAssetDir_getNextFileName 字面上只获取文件，还是gradle 的srcDirs 只复制 文件，或者整个AAssetManager 生态系统只适用于平面目录之类的。

令我惊讶的是，没有明确的文档显示“在您的 NDK 应用程序中包含资源目录”的用例，因为这似乎是一件很正常的事情。

---

编辑：有人要求我澄清一下：“cmake 是如何运行的”。我的build.gradle 文件中有以下sn-p：

  externalNativeBuild 
    cmake 
      version "3.18.1"
      path "../CMakeLists.txt"
      buildStagingDirectory buildDir
    
  

【参考方案1】：

好的，所以我的问题是三个方面：

gradle 负责构建我的 cmake 项目，该项目构建资源文件夹。因为在 cmake 过程和资产打包之间没有明确的依赖关系，它似乎是在不可预知的时间从该文件夹中提取出来的（可能在它的构建完成之前）。 （如果有人知道如何指定这样的依赖项，请告诉我！） 当我将文件夹设置为resources 时，它不会导致root/resources/images,shaders；结果为root/images,shaders。 （如果有人知道如何指定代替前者，请告诉我！） AAssetDir_getNextFileName 不枚举文件夹。 （对此我无能为力！）

【讨论】：

不清楚如何运行构建资源文件夹的cmake项目。

@AlexCohn 请参阅附加原始问题的编辑。我目前通过指向 gradle-directed cmake 构建之外的预构建资源目录“解决”了我的问题，尽管这需要我手动并有意识地确保该文件夹是最新的并且就位（与整点相反拥有构建系统）。因此，如果有人可以让我知道如何将 cmake 重新合并到 gradle 中，同时确保 gradle 等待 cmake 构建连接资源目录，我将不胜感激！

如果你能把这个非答案移到问题部分就好了。

【参考方案2】：

我建议直接使用AAssetManager_open(aassman, "/images/blah0.png") 而不是fopen("resources/images/blah0.png", "r")，但如果它对您很重要，您可以设置assets.srcDirs 'build/cmake/release/arm64-v8a 并排除除"resources" 之外的所有内容。

Here 是纯 C++ 解决方案的概要。或者，您也可以通过 JNI 调用 Java API（here）。