如何将Firebase数据存储到原生GearVR框架？加载立方体贴图崩溃求助

核心问题拆解 #

你现在碰到两个关键问题：

• 应用频繁崩溃，大概率和存储权限缺失、异步操作时机错误、GearVR初始化顺序混乱有关
• 无法正确获取Android外部存储路径，同时不知道怎么把数据库下载的立方体贴图集成到GearVR原生框架中

问题排查与修复步骤 #

1. 先搞定存储权限与路径问题 #

首先，getExternalFilesDir(null)在onCreate早期调用可能返回null——因为Activity还没完成初始化。另外，Android 13+需要额外的存储权限，先在AndroidManifest.xml里加权限：

<!-- Android 13+ 读写媒体权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<!-- 适配Android 12及以下版本的存储权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" />

而且不能直接在onCreate里访问存储，必须先请求运行时权限，用户同意后再操作。

2. 调整GearVR初始化与异步下载的顺序 #

你的原代码里，先启动Firebase下载，再调用super.onCreate(icicle)初始化GearVR——这会导致GearVR先加载，但此时立方体贴图还没下载好，或者存储操作触发崩溃。正确的逻辑应该是：

• 先请求存储权限
• 权限通过后启动Firebase下载
• 下载+解压完成后，再初始化GearVR主逻辑（或者下载失败时用默认资源兜底）

修复后的完整代码示例：

public class SampleActivity extends GVRActivity {
    private SampleMain main;
    private long lastDownTime = 0;
    // Firebase Storage引用
    private StorageReference cubemap_ref;
    private static final int STORAGE_PERMISSION_REQUEST = 1001;
    private File externalFilesDir;

    @Override
    protected void onCreate(Bundle icicle) {
        super.onCreate(icicle);
        // 等Activity初始化完成后再获取存储目录
        externalFilesDir = getExternalFilesDir(null);
        // 先请求存储权限
        requestStoragePermissions();
    }

    private void requestStoragePermissions() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_MEDIA_IMAGES) != PackageManager.PERMISSION_GRANTED) {
                ActivityResultContracts.RequestPermission requestPermission = new ActivityResultContracts.RequestPermission();
                registerForActivityResult(requestPermission, isGranted -> {
                    if (isGranted) {
                        startCubemapDownload();
                    } else {
                        Toast.makeText(this, "需要存储权限才能加载立方体贴图", Toast.LENGTH_SHORT).show();
                    }
                }).launch(Manifest.permission.READ_MEDIA_IMAGES);
            } else {
                startCubemapDownload();
            }
        } else {
            if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
                ActivityResultContracts.RequestMultiplePermissions requestPermissions = new ActivityResultContracts.RequestMultiplePermissions();
                registerForActivityResult(requestPermissions, permissions -> {
                    boolean allGranted = permissions.values().stream().allMatch(granted -> granted);
                    if (allGranted) {
                        startCubemapDownload();
                    } else {
                        Toast.makeText(this, "需要存储权限才能加载立方体贴图", Toast.LENGTH_SHORT).show();
                    }
                }).launch(new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE, Manifest.permission.READ_EXTERNAL_STORAGE});
            } else {
                startCubemapDownload();
            }
        }
    }

    private void startCubemapDownload() {
        FirebaseStorage storage = FirebaseStorage.getInstance();
        StorageReference storageRef = storage.getReference();
        cubemap_ref = storageRef.child("cubemaps/cubemap_example.zip");
        final long TEN_MEGABYTE = 1024 * 1024 * 10;

        cubemap_ref.getBytes(TEN_MEGABYTE).addOnSuccessListener(bytes -> {
            File zipFile = new File(externalFilesDir.getAbsolutePath(), "cubemap.zip");
            try {
                OutputStream os = new FileOutputStream(zipFile);
                os.write(bytes);
                os.close();
                // 解压ZIP到GearVR可访问的目录
                unzipCubemap(zipFile);
                // 用解压后的资源初始化GearVR
                initGearVR();
            } catch (IOException e) {
                android.util.Log.w("ExternalStorage", "写入文件失败: " + zipFile, e);
            }
        }).addOnFailureListener(exception -> {
            android.util.Log.e("FirebaseDownload", "立方体贴图下载失败", exception);
            // 下载失败时用默认资源初始化
            initGearVRWithDefault();
        });
    }

    private void unzipCubemap(File zipFile) throws IOException {
        // 创建解压目录，GearVR可以访问应用私有外部存储
        File cubemapDir = new File(externalFilesDir, "cubemaps");
        if (!cubemapDir.exists()) {
            cubemapDir.mkdirs();
        }
        // 解压ZIP文件
        ZipInputStream zis = new ZipInputStream(new FileInputStream(zipFile));
        ZipEntry entry;
        while ((entry = zis.getNextEntry()) != null) {
            File outputFile = new File(cubemapDir, entry.getName());
            if (entry.isDirectory()) {
                outputFile.mkdirs();
            } else {
                OutputStream os = new FileOutputStream(outputFile);
                byte[] buffer = new byte[1024];
                int len;
                while ((len = zis.read(buffer)) > 0) {
                    os.write(buffer, 0, len);
                }
                os.close();
            }
            zis.closeEntry();
        }
        zis.close();
        // 删除临时ZIP文件，节省空间
        zipFile.delete();
    }

    private void initGearVR() {
        // 把解压后的立方体贴图路径传给SampleMain
        String cubemapPath = externalFilesDir.getAbsolutePath() + "/cubemaps";
        main = new SampleMain(this, cubemapPath);
        setMain(main, "gvr.xml");
    }

    private void initGearVRWithDefault() {
        // 使用assets里的默认立方体贴图初始化
        main = new SampleMain(this);
        setMain(main, "gvr.xml");
    }
}

3. 集成到GearVR原生框架的关键要点 #

• GearVR支持从应用私有外部存储目录加载资源，getExternalFilesDir(null)返回的就是这个路径，无需额外授权就能访问
• 在SampleMain里，需要修改立方体贴图的加载逻辑，从解压后的目录读取6张面的图片（通常命名为posx、negx、posy、negy、posz、negz）
• 确保立方体贴图的格式符合GearVR要求：比如用PNG/JPG格式，尺寸为2的幂次方（如1024x1024）

额外注意事项 #

• 异步操作：Firebase下载是异步的，必须等回调完成后再初始化依赖资源的GearVR组件，否则会因为资源不存在崩溃
• 日志排查：多加异常日志，方便定位崩溃原因
• 资源清理：解压后删除临时ZIP文件，避免占用不必要的存储

内容的提问来源于stack exchange，提问作者Hans peter