你还在写重复的平台代码？掌握这4个技巧让.NET MAUI项目效率提升300%

第一章：.NET MAUI 平台特定代码的现状与挑战

平台差异带来的典型问题

• 硬件访问权限（如相机、GPS）在各平台上配置方式不同
• 用户界面行为存在细微差别，例如导航栏样式和手势响应
• 后台任务执行策略受操作系统限制，需分别处理

实现平台特定逻辑的常用方法

// 使用 #if 指令区分平台
#if ANDROID
    var toast = new Android.Widget.Toast(Application.Context);
    toast.Show();
#elif IOS
    var alert = UIAlertController.Create("提示", "这是iOS平台", UIAlertControllerStyle.Alert);
    UIApplication.SharedApplication.KeyWindow.RootViewController.PresentViewController(alert, true, null);
#endif

推荐的架构实践

第二章：深入理解平台特定代码的设计原理

2.1 平台特定代码的核心概念与运行机制

运行机制解析

const platform = MethodChannel('com.example/deviceInfo');
final String version = await platform.invokeMethod('getVersion');

关键特征

• 直接访问设备功能（如摄像头、传感器）
• 依赖平台ABI和运行时环境
• 需处理生命周期与权限控制

2.2 .NET MAUI 中依赖服务与原生API的交互模式

服务注册与解析机制

public interface IToastService
{
    void Show(string message);
}

// Android 实现
[Dependency]
public class ToastService : IToastService
{
    public void Show(string message)
    {
        Android.Widget.Toast.MakeText(Android.App.Application.Context, 
            message, ToastLength.Short).Show();
    }
}

平台差异处理策略

• 接口隔离：按功能拆分细粒度接口，避免平台不支持方法引发异常
• 空实现兜底：对非必现功能提供默认空实现，保障调用链完整性

2.3 使用 Partial Class 实现跨平台逻辑分离

基本语法与结构

public partial class DataService
{
    public string GetData()
    {
        return FormatData(FetchRawData());
    }

    private string FormatData(string raw) => $"Formatted: {raw}";
}

平台专属实现

// Android 平台实现
public partial class DataService
{
    private string FetchRawData() => "Android Raw Data";
}

• 提升代码可维护性
• 支持独立编译与测试
• 避免条件编译带来的复杂度

2.4 平台判定与条件编译的最佳实践

常用平台宏示例

#ifdef _WIN32
    // Windows 平台逻辑
#elif __linux__
    // Linux 平台逻辑
#elif __APPLE__
    #include <TargetConditionals.h>
    #if TARGET_OS_MAC
        // macOS 逻辑
    #endif
#endif

构建配置建议

• 避免硬编码平台判断逻辑，封装为统一头文件
• 优先使用编译器内置宏，减少自定义宏带来的维护成本
• 结合 CMake 或 Bazel 等构建系统实现自动化平台检测

2.5 性能影响分析与优化策略

性能瓶颈识别

缓存优化策略

var configCache = sync.Map{}

func GetConfig(key string) (string, bool) {
    if val, ok := configCache.Load(key); ok {
        return val.(string), true
    }
    // 模拟数据库读取
    result := queryFromDB(key)
    configCache.Store(key, result)
    return result, false
}

异步处理机制

第三章：四大提效技巧概览与应用场景

3.1 抽象通用平台功能提升复用率

核心组件抽象示例

// auth.go - 统一认证中间件
func AuthMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        token := r.Header.Get("Authorization")
        if !validateToken(token) {
            http.Error(w, "forbidden", http.StatusForbidden)
            return
        }
        next.ServeHTTP(w, r)
    })
}

复用收益对比

3.2 利用源生成器减少重复代码编写

工作原理

[Generator]
public class ToStringGenerator : ISourceGenerator
{
    public void Execute(GeneratorExecutionContext context)
    {
        var source = @"
namespace Generated
{
    partial class AutoToString
    {
        public override string ToString() => $""Id: {Id}, Name: {Name}"";
    }
}";
        context.AddSource("AutoToString.g.cs", source);
    }
}

func (b *Bridge) Invoke(service string, req interface{}) (*Response, error) {
    adapter, exists := b.adapters[service]
    if !exists {
        return nil, ErrServiceNotRegistered
    }
    return adapter.Execute(req)
}

type FileStorage interface {
    ReadFile(path string) ([]byte, error)
    WriteFile(path string, data []byte) error
    Exists(path string) bool
}

type Sensor interface {
    Start() error
    Stop() error
    Read(ctx context.Context) (*SensorData, error)
}

type SensorData struct {
    Timestamp int64
    Type      string
    Value     []float64
}

import { Platform, StatusBar, NavigationBar } from 'react-native';

if (Platform.OS === 'android') {
  StatusBar.setBackgroundColor('#1976D2');
  NavigationBar.setColor('#000000', true);
} else {
  StatusBar.setBarStyle('dark-content'); // iOS
}

const ThemeContext = createContext();

function ThemeProvider({ children }) {
  const [darkMode, setDarkMode] = useState(
    localStorage.getItem('darkMode') === 'true' || 
    window.matchMedia('(prefers-color-scheme: dark)').matches
  );

  useEffect(() => {
    document.body.classList.toggle('dark', darkMode);
    localStorage.setItem('darkMode', darkMode);
  }, [darkMode]);

  return (
    
      {children}
    
  );
}

final userProvider = FutureProvider.autoDispose((ref) async {
  ref.onCancel(() => print('User stream cancelled'));
  return await fetchCurrentUser();
});

// 在 Widget 中使用
ref.watch(userProvider).when(
  data: (user) => ProfileCard(user: user),
  error: (err, _) => Text('Failed: $err'),
  loading: () => CircularProgressIndicator(),
);