创建 Android App 自定义目录的完整指南

在开发 Android 应用时，常常需要管理文件，包括图像、音频或文档等。为了方便用户操作和应用管理，这里介绍如何在 Android 应用中创建自己的目录。

Android 文件存储机制

Android 应用提供了多种存储机制，包括内部存储、外部存储和云存储。内部存储适合存放私有数据，用户无法访问，而外部存储则可以与用户共享数据。为了建立自己的目录，我们通常使用外部存储。

权限设置

在 AndroidManifest.xml 文件中，我们需要请求存储权限。以下是所需的权限：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

在 Android 6.0 (API 级别 23) 及以上版本中，需要在运行时请求权限。可以使用 ActivityCompat 的 requestPermissions 方法。

创建自定义目录

以下是一个基本的示例，展示如何创建自定义目录及在其中保存文件。

1. 添加依赖

dependencies {
    implementation 'androidx.core:core:1.7.0'
}

2. 创建目录

我们可以在应用的外部存储中创建自定义目录。下面的代码展示了如何做到这一点：

import android.os.Environment;
import java.io.File;

public class FileUtils {

    public static File createCustomDirectory(String directoryName) {
        File customDirectory = new File(Environment.getExternalStorageDirectory(), directoryName);
        if (!customDirectory.exists()) {
            boolean success = customDirectory.mkdirs();
            if (success) {
                return customDirectory;
            } else {
                return null;
            }
        }
        return customDirectory;
    }
}

3. 文件操作示例

在创建了目录后，我们可以在该目录中创建和写入文件。以下是一个简单的文件写入示例：

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;

public class FileUtils {

    public static void writeFile(File directory, String fileName, String content) {
        File file = new File(directory, fileName);
        try (FileOutputStream fos = new FileOutputStream(file)) {
            fos.write(content.getBytes());
            fos.flush();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

4. 使用示例

在 Activity 中，我们可以使用 FileUtils 来创建目录并写入文件。以下是一个示例：

import android.Manifest;
import android.content.pm.PackageManager;
import android.os.Bundle;
import android.widget.Toast;
import androidx.annotation.NonNull;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.app.ActivityCompat;
import androidx.core.content.ContextCompat;

public class MainActivity extends AppCompatActivity {

    private static final int REQUEST_STORAGE_PERMISSION = 1;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE)
                != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this,
                    new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, REQUEST_STORAGE_PERMISSION);
        } else {
            performFileOperations();
        }
    }

    private void performFileOperations() {
        File customDirectory = FileUtils.createCustomDirectory("MyAppDirectory");
        if (customDirectory != null) {
            FileUtils.writeFile(customDirectory, "example.txt", "Hello, world!");
            Toast.makeText(this, "文件已创建!", Toast.LENGTH_SHORT).show();
        } else {
            Toast.makeText(this, "目录创建失败!", Toast.LENGTH_SHORT).show();
        }
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
        if (requestCode == REQUEST_STORAGE_PERMISSION) {
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                performFileOperations();
            }
        }
    }
}

类图

以下是相关类的 UML 类图：

classDiagram
    class FileUtils {
        +File createCustomDirectory(String directoryName)
        +void writeFile(File directory, String fileName, String content)
    }
    class MainActivity {
        +void onCreate(Bundle savedInstanceState)
        +void performFileOperations()
    }

总结

通过以上代码示例，我们学会了如何在 Android 应用中创建自定义目录并进行文件操作。使用外部存储时，请确保用户同意相关权限，以便顺利进行文件的读写操作。掌握这些基础知识后，你可以更灵活地管理你的应用数据，让用户能够方便地找到他们所需的文件。