Платформозависимый код Flutter
В этом разделе будет рассказано, как использовать платформенные каналы для вызова нативного кода платформы во Flutter.
Обзор платформенных каналов
Платформенные каналы позволяют коду Dart взаимодействовать с нативными платформами (iOS/Android).
| Type | Описание |
|---|---|
| MethodChannel | Каналы методов, используемые для вызова методов платформы |
| EventChannel | Каналы событий, используемые для потоковой передачи данных |
Вызов со стороны Dart
Пример: использование MethodChannel
import 'package:flutter/services.dart';
// Определяем канал
class PlatformChannel {
static const MethodChannel _channel = MethodChannel('my_app/channel');
// Вызвать нативный метод — получить уровень заряда батареи
static Future<int> getBatteryLevel() async {
try {
final int batteryLevel = await _channel.invokeMethod('getBatteryLevel');
return batteryLevel;
} on PlatformException catch (e) {
print('Не удалось получить уровень заряда батареи: ${e.message}');
return -1;
}
}
// Вызвать нативный метод — показать Toast
static Future<void> showToast(String message) async {
try {
await _channel.invokeMethod('showToast', {'message': message});
} on PlatformException catch (e) {
print('Не удалось показать Toast: ${e.message}');
}
}
// Вызов нативного метода — получение информации об устройстве
static Future<Map<String, dynamic>> getDeviceInfo() async {
try {
final result = await _channel.invokeMapMethod('getDeviceInfo');
return result ?? {};
} on PlatformException catch (e) {
print(Не удалось получить информацию об устройстве: ${e.message});
return {};
}
}
}
// Пример использования
class MyWidget extends StatelessWidget {
const MyWidget({super.key});
@override
Widget build(BuildContext context) {
return ElevatedButton(
onPressed: () async {
final battery = await PlatformChannel.getBatteryLevel();
print(Уровень заряда батареи: $battery%);
},
child: const Text(Получить уровень заряда батареи),
);
}
}
// Определяем канал
class PlatformChannel {
static const MethodChannel _channel = MethodChannel('my_app/channel');
// Вызвать нативный метод — получить уровень заряда батареи
static Future<int> getBatteryLevel() async {
try {
final int batteryLevel = await _channel.invokeMethod('getBatteryLevel');
return batteryLevel;
} on PlatformException catch (e) {
print('Не удалось получить уровень заряда батареи: ${e.message}');
return -1;
}
}
// Вызвать нативный метод — показать Toast
static Future<void> showToast(String message) async {
try {
await _channel.invokeMethod('showToast', {'message': message});
} on PlatformException catch (e) {
print('Не удалось показать Toast: ${e.message}');
}
}
// Вызов нативного метода — получение информации об устройстве
static Future<Map<String, dynamic>> getDeviceInfo() async {
try {
final result = await _channel.invokeMapMethod('getDeviceInfo');
return result ?? {};
} on PlatformException catch (e) {
print(Не удалось получить информацию об устройстве: ${e.message});
return {};
}
}
}
// Пример использования
class MyWidget extends StatelessWidget {
const MyWidget({super.key});
@override
Widget build(BuildContext context) {
return ElevatedButton(
onPressed: () async {
final battery = await PlatformChannel.getBatteryLevel();
print(Уровень заряда батареи: $battery%);
},
child: const Text(Получить уровень заряда батареи),
);
}
}
Реализация для Android (Kotlin)
Пример: код на стороне Android
// MainActivity.kt
package com.example.my_app
import android.os.Bundle
import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel
class MainActivity : FlutterActivity() {
private val CHANNEL = "my_app/channel"
override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
super.configureFlutterEngine(flutterEngine)
MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL)
.setMethodCallHandler { call, result ->
when (call.method) {
"getBatteryLevel" -> {
val batteryLevel = getBatteryLevel()
if (batteryLevel != -1) {
result.success(batteryLevel)
} else {
result.error("UNAVAILABLE", "Не удалось получить уровень заряда батареи", null)
}
}
"showToast" -> {
val message = call.argument<String>("message")
showToast(message!!)
result.success(null)
}
else -> {
result.notImplemented()
}
}
}
}
private fun getBatteryLevel(): Int {
return try {
val batteryManager = getSystemService(BATTERY_SERVICE) as BatteryManager
batteryManager.getIntProperty(BatteryManager.BATTERY_PROPERTY_CAPACITY)
} catch (e: Exception) {
-1
}
}
private fun showToast(message: String) {
android.widget.Toast.makeText(this, message, android.widget.Toast.LENGTH_SHORT).show()
}
}
package com.example.my_app
import android.os.Bundle
import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel
class MainActivity : FlutterActivity() {
private val CHANNEL = "my_app/channel"
override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
super.configureFlutterEngine(flutterEngine)
MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL)
.setMethodCallHandler { call, result ->
when (call.method) {
"getBatteryLevel" -> {
val batteryLevel = getBatteryLevel()
if (batteryLevel != -1) {
result.success(batteryLevel)
} else {
result.error("UNAVAILABLE", "Не удалось получить уровень заряда батареи", null)
}
}
"showToast" -> {
val message = call.argument<String>("message")
showToast(message!!)
result.success(null)
}
else -> {
result.notImplemented()
}
}
}
}
private fun getBatteryLevel(): Int {
return try {
val batteryManager = getSystemService(BATTERY_SERVICE) as BatteryManager
batteryManager.getIntProperty(BatteryManager.BATTERY_PROPERTY_CAPACITY)
} catch (e: Exception) {
-1
}
}
private fun showToast(message: String) {
android.widget.Toast.makeText(this, message, android.widget.Toast.LENGTH_SHORT).show()
}
}
Реализация для iOS (Swift)
Пример: код на стороне iOS
// AppDelegate.swift
import Flutter
import UIKit
@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
private let CHANNEL = "my_app/channel"
override func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
let controller = window?.rootViewController as! FlutterViewController
let channel = FlutterMethodChannel(
name: CHANNEL,
binaryMessenger: controller.binaryMessenger
)
channel.setMethodCallHandler { (call: FlutterMethodCall, result: @escaping FlutterResult) in
switch call.method {
case "getBatteryLevel":
self.getBatteryLevel(result: result)
case "showToast":
if let args = call.arguments as? [String: Any],
let message = args["message"] as? String {
self.showToast(message: message)
result(nil)
}
default:
result(FlutterMethodNotImplemented)
}
}
return super.application(application, didFinishLaunchingWithOptions: launchOptions)
}
private func getBatteryLevel(result: @escaping FlutterResult) {
UIDevice.current.isBatteryMonitoringEnabled = true
let batteryLevel = UIDevice.current.batteryLevel
if batteryLevel < 0 {
result(FlutterError(code: "UNAVAILABLE", message: "Не удалось получить уровень заряда батареи", details: nil))
} else {
result(Int(batteryLevel * 100))
}
}
private func showToast(message: String) {
let alert = UIAlertController(title: nil, message: message, preferredStyle: .alert)
present(alert, animated: true)
DispatchQueue.main.asyncAfter(deadline: .now() + 1.5) {
alert.dismiss(animated: true)
}
}
}
import Flutter
import UIKit
@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
private let CHANNEL = "my_app/channel"
override func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
) -> Bool {
let controller = window?.rootViewController as! FlutterViewController
let channel = FlutterMethodChannel(
name: CHANNEL,
binaryMessenger: controller.binaryMessenger
)
channel.setMethodCallHandler { (call: FlutterMethodCall, result: @escaping FlutterResult) in
switch call.method {
case "getBatteryLevel":
self.getBatteryLevel(result: result)
case "showToast":
if let args = call.arguments as? [String: Any],
let message = args["message"] as? String {
self.showToast(message: message)
result(nil)
}
default:
result(FlutterMethodNotImplemented)
}
}
return super.application(application, didFinishLaunchingWithOptions: launchOptions)
}
private func getBatteryLevel(result: @escaping FlutterResult) {
UIDevice.current.isBatteryMonitoringEnabled = true
let batteryLevel = UIDevice.current.batteryLevel
if batteryLevel < 0 {
result(FlutterError(code: "UNAVAILABLE", message: "Не удалось получить уровень заряда батареи", details: nil))
} else {
result(Int(batteryLevel * 100))
}
}
private func showToast(message: String) {
let alert = UIAlertController(title: nil, message: message, preferredStyle: .alert)
present(alert, animated: true)
DispatchQueue.main.asyncAfter(deadline: .now() + 1.5) {
alert.dismiss(animated: true)
}
}
}
Другие расширенияПлатформенные каналы — основной способ взаимодействия Flutter с нативным кодом; обычно они используются для вызова системных API, аппаратных возможностей или сторонних нативных SDK.