PAYATHON 2026

如何用 Java 读写 Google Drive 文本文件,在两部 Android 手机间共享字符串?

数据小陈

可以使用 Google Drive API v3,将字符串保存为 text/plain 文件。两部手机分别获得用户授权后,通过同一个 fileId 读取或更新文件,就能共享这份字符串。

还需要处理刷新和冲突。一台手机上传成功后,另一台手机需要重新读取文件,界面才会显示更新后的字符串。

配置 Android 授权

  1. 在 Google Cloud 项目中启用 Google Drive API,配置 OAuth 同意屏幕。
  2. 创建 Android OAuth 客户端,填写应用的包名和签名证书 SHA-1。
  3. 在应用中请求访问 Drive 的授权。Android 可使用 AuthorizationClient;登录账号与授权访问 Drive 是两个不同的步骤,具体流程见 Android 授权指南。
  4. 对于由应用创建的共享文件,可以请求 https://www.googleapis.com/auth/drive.file。这个 scope 允许访问应用创建或用户明确授权给应用的文件,不能任意读写用户 Drive 中的所有文件,详见 Drive 权限范围说明。

如果两部手机使用同一个 Google 账号,需要让两端定位到同一份文件;如果使用不同账号,还需要将文件共享给另一个账号、授予编辑权限,并确保应用获得访问该文件的授权。仅知道 fileId 不代表拥有访问权限。

使用 Java 创建、读取和更新文件

示例使用 Google Drive API v3 的 Java 客户端,假设已经完成 OAuth 授权,并构建了能够携带有效 access token 的 Drive 实例。示例不包含授权界面、客户端初始化和界面更新代码。

import com.google.api.client.http.ByteArrayContent;
import com.google.api.services.drive.Drive;
import com.google.api.services.drive.model.File;

import java.io.ByteArrayOutputStream;
import java.io.IOException;

public final class DriveTextStore {
    private final Drive drive;

    public DriveTextStore(Drive drive) {
        this.drive = drive;
    }

    // 首次初始化时创建文件,并保存返回的 fileId。
    public String create(String initialValue) throws IOException {
        File metadata = new File()
                .setName("shared-value.txt")
                .setMimeType("text/plain");

        ByteArrayContent content = ByteArrayContent.fromString(
                "text/plain; charset=UTF-8", initialValue);

        File created = drive.files()
                .create(metadata, content)
                .setFields("id")
                .execute();

        return created.getId();
    }

    public String read(String fileId) throws IOException {
        try (ByteArrayOutputStream output = new ByteArrayOutputStream()) {
            drive.files().get(fileId)
                    .executeMediaAndDownloadTo(output);
            return output.toString("UTF-8");
        }
    }

    // 用新字符串替换整个文件内容。
    public void write(String fileId, String value) throws IOException {
        ByteArrayContent content = ByteArrayContent.fromString(
                "text/plain; charset=UTF-8", value);

        drive.files().update(fileId, null, content).execute();
    }
}

创建时同时上传文件名和内容;更新时调用 files.update 上传新的文本内容,接口用法见 文件上传指南。读取普通 txt 文件时,使用 files.get 下载内容。Java 客户端的 executeMediaAndDownloadTo 会处理对应的媒体下载请求,详见 文件下载指南。

Android 应用还需要在 AndroidManifest.xml 中声明网络权限,并在后台线程执行这些网络调用:

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

让两部手机找到同一个文件

不要让每部手机在启动时都调用 create(),否则会生成两份独立文件。

首次初始化时创建文件并保存返回的 fileId。另一部手机需要先找到该文件,再使用它的 ID。对于应用有权访问的文件,可以通过 files.list 按名称查询,例如:

name = 'shared-value.txt' and trashed = false

Drive 允许文件重名,因此查询结果可能不止一个。应让用户确认目标文件,或为应用文件设置可查询的自定义标记。列表查询还需要处理分页,具体见 文件搜索指南。

将 ID 存在第一部手机的本地配置中,可以方便这台手机再次访问;第二部手机仍需要定位文件并获得授权。

处理刷新、失败和同时修改

可以在用户打开页面或点击刷新时调用 read(),编辑后点击保存时调用 write()。上传成功后才应显示“已同步”;网络失败时,保留未上传的修改并提供重试入口。access token 失效时,需要通过授权流程重新获取有效令牌。

上面的代码会覆盖整个文件,没有实现并发冲突控制。例如,两部手机都读取了旧值,随后分别上传不同的新值,其中一次修改可能被另一次覆盖。保存前重新读取有助于发现已经发生的变化,但不能消除读取与写入之间的竞争。

如果可以接受偶尔刷新,且很少同时修改,这种文件共享方式可以满足需求。如果要求同时编辑时不丢失修改,就需要进一步设计冲突检测、合并或服务端写入协调机制。

备注:内容仅供参考。