Flutter Odoo集成插件odoo_provider的使用

odoo_provider 是一个用于 Flutter 应用与 Odoo (之前称为 OpenERP) 集成的插件。它允许你在 Flutter 应用中轻松地与 Odoo 后端进行交互，执行常见的 CRUD 操作，并处理 Odoo 的认证和会话管理。

以下是使用 odoo_provider 插件的基本步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 odoo_provider 依赖：

dependencies:
  flutter:
    sdk: flutter
  odoo_provider: ^0.0.1  # 请确保使用最新版本

然后运行 flutter pub get 来安装依赖。

2. 初始化 Odoo 客户端

在你的 Flutter 应用中，首先需要初始化 Odoo 客户端。通常，你可以在 main.dart 文件中的 main 函数中完成这个操作。

import 'package:flutter/material.dart';
import 'package:odoo_provider/odoo_provider.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // 初始化 Odoo 客户端
  final odooClient = OdooClient(baseUrl: 'https://your-odoo-instance.com');

  runApp(MyApp(odooClient: odooClient));
}

class MyApp extends StatelessWidget {
  final OdooClient odooClient;

  MyApp({required this.odooClient});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Odoo Flutter App',
      home: OdooProvider(
        odooClient: odooClient,
        child: MyHomePage(),
      ),
    );
  }
}

3. 使用 OdooProvider 访问 Odoo 客户端

在你的页面或 Widget 中，你可以使用 OdooProvider.of(context) 来获取 OdooClient 实例，并使用它来执行各种操作。

import 'package:flutter/material.dart';
import 'package:odoo_provider/odoo_provider.dart';

class MyHomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    final odooClient = OdooProvider.of(context).odooClient;

    return Scaffold(
      appBar: AppBar(
        title: Text('Odoo Integration'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () async {
            // 登录到 Odoo
            final loggedIn = await odooClient.login(
              database: 'your_database',
              login: 'your_username',
              password: 'your_password',
            );

            if (loggedIn) {
              print('Logged in successfully!');

              // 读取数据
              final records = await odooClient.searchRead(
                model: 'res.partner',
                domain: [],
                fields: ['id', 'name'],
              );

              print('Records: $records');
            } else {
              print('Login failed!');
            }
          },
          child: Text('Login and Fetch Data'),
        ),
      ),
    );
  }
}

4. 执行 CRUD 操作

使用 OdooClient 实例，你可以执行各种 CRUD 操作。以下是一些常见的操作示例：

• 查询数据:

  final records = await odooClient.searchRead(
    model: 'res.partner',
    domain: [],
    fields: ['id', 'name'],
  );
  

• 创建数据:

  final newRecordId = await odooClient.create(
    model: 'res.partner',
    values: {
      'name': 'New Partner',
      'email': 'partner@example.com',
    },
  );
  

• 更新数据:

  final updated = await odooClient.write(
    model: 'res.partner',
    id: newRecordId,
    values: {
      'name': 'Updated Partner',
    },
  );
  

• 删除数据:

  final deleted = await odooClient.unlink(
    model: 'res.partner',
    id: newRecordId,
  );
  

5. 处理会话和认证

odoo_provider 插件会自动处理会话管理和认证。你可以使用 login 方法进行登录，使用 logout 方法进行注销。

final loggedIn = await odooClient.login(
  database: 'your_database',
  login: 'your_username',
  password: 'your_password',
);

if (loggedIn) {
  print('Logged in successfully!');
} else {
  print('Login failed!');
}

// 注销
await odooClient.logout();

6. 错误处理

在使用 odoo_provider 进行 Odoo 集成时，确保处理可能的错误。例如，网络错误、认证失败或 Odoo 后端返回的错误。

try {
  final records = await odooClient.searchRead(
    model: 'res.partner',
    domain: [],
    fields: ['id', 'name'],
  );
  print('Records: $records');
} catch (e) {
  print('Error: $e');
}