一周掌握Flutter开发--9. 与原生交互（上）

news2025/4/2 23:39:32

在这里插入图片描述

文章目录

- - 9. 与原生交互
  - 核心场景
  - - 9.1 调用平台功能：`MethodChannel`
    - - 9.1.1 Flutter 端实现
      - 9.1.2 Android 端实现
      - 9.1.3 iOS 端实现
      - 9.1.4 使用场景
    - 9.2 使用社区插件
    - - 9.2.1 常用插件
      - 9.2.2 插件的优势
  - 总结

9. 与原生交互

Flutter 提供了强大的跨平台开发能力，但在某些场景下，可能需要调用平台特定的功能（如相机、GPS、传感器等）。Flutter 通过 平台通道（Platform Channel） 实现与原生代码的交互。以下是详细讲解。

核心场景

9.1 调用平台功能：`MethodChannel`

MethodChannel 是 Flutter 与原生代码（Android/iOS）通信的核心机制。通过 MethodChannel，Flutter 可以调用原生代码的功能，并接收返回结果。

9.1.1 Flutter 端实现

创建 MethodChannel：

import 'package:flutter/services.dart';

class NativeBridge {
  static const platform = MethodChannel('com.example.app/native');

  // 调用原生方法
  static Future<String> getPlatformVersion() async {
    try {
      final String result = await platform.invokeMethod('getPlatformVersion');
      return result;
    } on PlatformException catch (e) {
      return 'Failed to get platform version: ${e.message}';
    }
  }
}

调用原生方法：

void fetchPlatformVersion() async {
  String platformVersion = await NativeBridge.getPlatformVersion();
  print('Platform Version: $platformVersion');
}

9.1.2 Android 端实现

在 MainActivity 中实现 MethodChannel：

package com.example.app;

import androidx.annotation.NonNull;
import io.flutter.embedding.android.FlutterActivity;
import io.flutter.embedding.engine.FlutterEngine;
import io.flutter.plugin.common.MethodChannel;

public class MainActivity extends FlutterActivity {
    private static final String CHANNEL = "com.example.app/native";

    @Override
    public void configureFlutterEngine(@NonNull FlutterEngine flutterEngine) {
        super.configureFlutterEngine(flutterEngine);
        new MethodChannel(flutterEngine.getDartExecutor().getBinaryMessenger(), CHANNEL)
            .setMethodCallHandler(
                (call, result) -> {
                    if (call.method.equals("getPlatformVersion")) {
                        String version = android.os.Build.VERSION.RELEASE;
                        result.success(version);
                    } else {
                        result.notImplemented();
                    }
                }
            );
    }
}

9.1.3 iOS 端实现

在 AppDelegate 中实现 MethodChannel：

#import "AppDelegate.h"
#import <Flutter/Flutter.h>

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    FlutterViewController* controller = (FlutterViewController*)self.window.rootViewController;

    FlutterMethodChannel* channel = [FlutterMethodChannel
        methodChannelWithName:@"com.example.app/native"
        binaryMessenger:controller.binaryMessenger];

    [channel setMethodCallHandler:^(FlutterMethodCall* call, FlutterResult result) {
        if ([@"getPlatformVersion" isEqualToString:call.method]) {
            NSString *version = [[UIDevice currentDevice] systemVersion];
            result(version);
        } else {
            result(FlutterMethodNotImplemented);
        }
    }];

    return [super application:application didFinishLaunchingWithOptions:launchOptions];
}

@end

9.1.4 使用场景

调用平台特定的 API（如获取设备信息、访问传感器）。
实现 Flutter 不支持的功能（如自定义硬件交互）。

9.2 使用社区插件

Flutter 社区提供了大量插件，封装了常见的平台功能（如相机、GPS、文件存储等），开发者可以直接使用这些插件，而无需手动实现原生代码。

9.2.1 常用插件

camera：访问设备相机。

安装：
```
dependencies:
  camera: ^0.10.0
```

使用示例：

import 'package:camera/camera.dart';

class CameraScreen extends StatefulWidget {
  @override
  _CameraScreenState createState() => _CameraScreenState();
}

class _CameraScreenState extends State<CameraScreen> {
  CameraController? _controller;

  @override
  void initState() {
    super.initState();
    _initializeCamera();
  }

  Future<void> _initializeCamera() async {
    final cameras = await availableCameras();
    final camera = cameras.first;
    _controller = CameraController(
      camera,
      ResolutionPreset.medium,
    );
    await _controller!.initialize();
    if (!mounted) return;
    setState(() {});
  }

  @override
  Widget build(BuildContext context) {
    if (_controller == null || !_controller!.value.isInitialized) {
      return Center(child: CircularProgressIndicator());
    }
    return CameraPreview(_controller!);
  }

  @override
  void dispose() {
    _controller?.dispose();
    super.dispose();
  }
}

geolocator：获取设备位置。

安装：
```
dependencies:
  geolocator: ^9.0.0
```

使用示例：

import 'package:geolocator/geolocator.dart';

void getLocation() async {
  bool serviceEnabled = await Geolocator.isLocationServiceEnabled();
  if (!serviceEnabled) {
    return; // 位置服务未启用
  }

  LocationPermission permission = await Geolocator.checkPermission();
  if (permission == LocationPermission.denied) {
    permission = await Geolocator.requestPermission();
    if (permission == LocationPermission.denied) {
      return; // 权限被拒绝
    }
  }

  Position position = await Geolocator.getCurrentPosition();
  print('Latitude: ${position.latitude}, Longitude: ${position.longitude}');
}