升级Couchbase Lite至2.0.0后出现无法解析符号错误求助

嘿，这个问题我太熟了——Couchbase Lite 2.x和1.x之间是彻底的API重构，光改依赖版本肯定不够，你遇到的类找不到问题，全是因为包路径、类结构甚至初始化逻辑都变了。我给你一步步梳理要改的地方：

1. 补上最关键的初始化步骤 #

2.0.0开始不再需要AndroidContext这个类了，但必须先在你的Application类的onCreate()里初始化CouchbaseLite框架，否则所有数据库操作都会报错：

import com.couchbase.lite.CouchbaseLite;

public class MyApp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        // 必须先执行这一步
        CouchbaseLite.init(getApplicationContext());
    }
}

别忘了在AndroidManifest.xml里指定这个Application类哦。

2. 替换旧的类导入 #

把原来的旧包导入全部替换成2.x的对应类：

• 删掉import com.couchbase.lite.AndroidContext;（这个类已经被移除）
• 保留import com.couchbase.lite.Database;，但它的构造方式变了
• 把原来的Document操作换成：
  • 只读文档：import com.couchbase.lite.Document;
  • 可修改文档：import com.couchbase.lite.MutableDocument;（2.x把读写文档拆成了两个类）

3. 重构数据库和文档操作的代码 #

举个最常见的对比，你就能明白差异：

1.4.0时代的代码（旧）： #

// 创建数据库
Database db = new Database("myDatabase", new AndroidContext(context));
// 创建并保存文档
Document doc = db.createDocument("user_1");
doc.putProperties(new HashMap<String, Object>() {{
    put("username", "mr_nooby_noob");
    put("age", 25);
}});

2.0.0时代的代码（新）： #

// 先确保已经在Application里初始化了CouchbaseLite
// 创建数据库配置
DatabaseConfiguration config = new DatabaseConfiguration(context);
// 初始化数据库
Database db = new Database("myDatabase", config);
// 创建可修改文档并保存
MutableDocument doc = new MutableDocument("user_1")
    .setString("username", "mr_nooby_noob")
    .setInt("age", 25);
db.save(doc);

额外提醒：API逻辑的其他变化 #

• 2.x默认优先异步操作，很多原来的同步方法都有了异步重载，比如查询、文档同步
• 同步功能（原来的Replication）也重构为Replicator类，如果你用到同步，也要对应修改代码

按照上面的步骤改完，那些“cannot resolve symbol”的错误应该就全消失了～

内容的提问来源于stack exchange，提问作者mr nooby noob