Implementação de Funcionalidades de Atalho em Aplicativos Flutter para OpenHarmony

Resumo

Este artigo aborda a implementação prática da funcionalidade de atalhos em aplicativos Flutter para o sistema OpenHarmony. Através do uso de menus de atalho, gestos e suporte a teclas de atalho, é possível melhorar significativamente a eficiência operacional no dispositivo. O objetivo principle é criar um sistema completo que engllobe essas três áreas principais, garantindo uma experiência de usuário mais rápida e itnuitiva.

Objetivos e Pontos Técnicos

1. Criação de um Framework Centralizado: Implementar um serviço centralizado para gerenciar todos os tipos de atalhos.
2. Menus de Atalho: Oferecer suporte para registrar e gerenciar itens de menu de atalho, categorizados por edição, navegação, ações e sistema.
3. Gestos de Atalho: Permitir vincular gestos específicos às ações dos atalhos.
4. Teclas de Atalho: Suporte para interpretação e execução de combinações de teclado, incluindo modificadoras como Ctrl, Alt e Shift.

Passo 1: Criação do Serviço Central de Atalhos

No diretório lib/services/, crie o arquivo shortcut_service.dart para definir o framework central do serviço de atalhos.

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

enum ShortcutType {
  menu,
  gesture,
  keyboard,
}

enum ShortcutCategory {
  navigation,
  edit,
  action,
  system,
}

class ShortcutInfo {
  final String id;
  final ShortcutType type;
  final ShortcutCategory category;
  final String title;
  final String description;
  final String? shortcutKey;
  final VoidCallback? action;
  final bool isEnabled;

  ShortcutInfo({
    required this.id,
    required this.type,
    required this.category,
    required this.title,
    required this.description,
    this.shortcutKey,
    this.action,
    this.isEnabled = true,
  });

  Map<String, dynamic> toJson() {
    return {
      'id': id,
      'type': type.index,
      'category': category.index,
      'title': title,
      'description': description,
      'shortcutKey': shortcutKey,
      'isEnabled': isEnabled,
    };
  }
}

class ShortcutService {
  static final ShortcutService _instance = ShortcutService._internal();
  factory ShortcutService() => _instance;
  ShortcutService._internal();

  final List<ShortcutInfo> _shortcuts = [];
  final List<ShortcutInfo> _logActions = [];

  void initializeDefaultShortcuts() {
    _shortcuts.addAll([
      ShortcutInfo(
        id: 'copy',
        type: ShortcutType.keyboard,
        category: ShortcutCategory.edit,
        title: 'Copiar',
        description: 'Copiar conteúdo selecionado',
        shortcutKey: 'Ctrl+C',
        action: () => debugPrint('Copy triggered'),
      ),
      ShortcutInfo(
        id: 'paste',
        type: ShortcutType.keyboard,
        category: ShortcutCategory.edit,
        title: 'Colar',
        description: 'Colar conteúdo do clipboard',
        shortcutKey: 'Ctrl+V',
        action: () => debugPrint('Paste triggered'),
      ),
      // Adicione outros atalhos conforme necessário
    ]);
  }

  List<ShortcutInfo> getShortcutsByCategory(ShortcutCategory category) {
    return _shortcuts.where((s) => s.category == category).toList();
  }

  void executeAction(ShortcutInfo shortcut) {
    if (shortcut.isEnabled && shortcut.action != null) {
      shortcut.action!();
      _logActions.add(shortcut);
    }
  }
}

Passo 2: Implementação do Menu de Atalhos

Desenvolva um widget que exibe os atalhos registrados no serviço.

class ShortcutMenu extends StatelessWidget {
  final ShortcutCategory category;

  const ShortcutMenu({super.key, required this.category});

  @override
  Widget build(BuildContext context) {
    final service = ShortcutService();
    final shortcuts = service.getShortcutsByCategory(category);

    return ListView.builder(
      itemCount: shortcuts.length,
      itemBuilder: (context, index) {
        final shortcut = shortcuts[index];
        return ListTile(
          title: Text(shortcut.title),
          subtitle: Text(shortcut.description),
          trailing: shortcut.shortcutKey != null
              ? Chip(label: Text(shortcut.shortcutKey!))
              : null,
          onTap: () => service.executeAction(shortcut),
        );
      },
    );
  }
}

Passo 3: Vinculação de Gestos

Adicione métodos ao ShortcutService para vincular gestos a ações.

void bindGestureToAction(String gestureId, String shortcutId) {
  final shortcut = _shortcuts.firstWhere((s) => s.id == shortcutId);
  _shortcuts.add(
    ShortcutInfo(
      id: '${shortcut.id}_gesture',
      type: ShortcutType.gesture,
      category: shortcut.category,
      title: shortcut.title,
      description: shortcut.description,
      shortcutKey: gestureId,
      action: shortcut.action,
    ),
  );
}

Passo 4: Suporte a Teclas de Atalho

Expanda o serviço para interpretar combinações de teclado.

ShortcutInfo? parseKeyboardShortcut(String keyCombination) {
  return _shortcuts.firstWhere(
    (s) => s.shortcutKey == keyCombination,
    orElse: () => null,
  );
}

void executeKeyboardShortcut(String keyCombination) {
  final shortcut = parseKeyboardShortcut(keyCombination);
  if (shortcut != null) {
    executeAction(shortcut);
  }
}

Conclusão

Este guia detalha a criação de um sistema robusto de atalhos em aplicativos Flutter para OpenHarmony. A abordagem utiliza serviços centralizados e widgets reutilizáveis, promovendo uma experiência fluida e eficiente.