Flutter地址选择插件address_sf_package的使用

Flutter地址选择插件address_sf_package的使用

该插件用于从Salesforce导出的数据中选择地址，用户可以选择省、市、区并输入准确的地址。

特性

• 读取从数据导出的地址数据。
• 初始化已有的位置以显示现有信息。
• 通过在搜索栏中输入名称来搜索地址，并在下拉列表中显示结果。
• 返回所选的位置或省、市、区。
• 处理当选择省、市、区时的逻辑。

使用方法

方法一：下载包并添加到项目中

1. 将插件包下载到你的项目目录中。
2. 在 pubspec.yaml 文件中添加以下配置：

dependencies:
  address_sf_package:
    path: ./address_sf_package

方法二：通过GitHub链接添加到项目中

1. 在 pubspec.yaml 文件中添加以下配置：

dependencies:
  address_sf_package:
    git:
      url: https://github.com/hlongho/address_sf_package.git
      ref: main

1. 导入插件：

import 'package:address_sf_package/address_sf_package.dart';

方法三：从pub.dev导入

1. 运行以下命令将插件添加到项目中：

flutter pub add address_sf_package

示例代码

// 导入必要的包
import 'dart:developer';

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

// 主应用类
void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

// 主页面类
class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});
  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        backgroundColor: Theme.of(context).colorScheme.inversePrimary,
        title: Text(widget.title),
      ),
      body: Center(
        child: Padding(
          padding: const EdgeInsets.all(8.0),
          child: AddressSfPackage(
            // 当地址改变时触发的回调函数
            onChangeAddress: (address) {
              log(address);
            },
            // 当选择省、市、区时触发的回调函数
            onSelectedProvinceDistrictWard: (province, district, ward) {
              log(province?.name ?? '未选择省份');
              log(district?.name ?? '未选择城市');
              log(ward?.name ?? '未选择区县');
            },
            // 地址数据文件路径
            addressPathJson: 'assets/address/address_dev.json',
            // 初始地址
            initAddress: '',
            // 初始省
            initProvince: null,
            // 初始市
            initDistrict: null,
            // 初始区
            initWard: null,
          ),
        ),
      ),
    );
  }
}

如何将JSON地址文件添加到项目中

1. 将已导出的JSON地址文件放置在项目的 assets/address/address_dev.json 路径下。
2. 在 pubspec.yaml 文件中添加以下配置：

flutter:
  assets:
    - assets/address/

示例数据

你可以从以下链接获取示例数据：

• 示例数据

注意事项

如果在iOS设备上导入后运行失败，请确保以下设置：

• 在 Podfile 中设置平台版本为 12.0：

  platform :ios, '12.0'