flutter_windowmanager

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Um plugin do Flutter que permite manipular os LayoutParams do WindowManager do Android, permitindo que desenvolvedores controlem a posição, o tamanho e o comportamento das janelas em um aplicativo Android. Ele fornece acesso direto às propriedades de janela de nível de sistema, útil para criar widgets flutuantes, sobreposições ou elementos de interface personalizados que persistem entre atividades. O plugin foi especificamente projetado para Android e se integra com o SDK nativo do Android por meio de canais de plataforma. Ele suporta recursos avançados de gerenciamento de janelas, como ajustar programaticamente o tipo de janela, a focabilidade e os parâmetros de layout.

Casos de uso

Criando sobreposições de UI flutuantes
Criando widgets sempre no topo
Implementando posicionamento personalizado de janela
Desenvolvendo ferramentas de gravação de tela ou anotação
Gerenciando janelas transparentes ou semitransparentes

Principais recursos

Acesso direto aos LayoutParams do WindowManager
Suporte para personalização de tipo de janela
Controle programático sobre o tamanho e posição da janela
Funcionalidades específicas do Android
Integração com o SDK nativo do Android

Indicado para

aplicativos exclusivos para Android que exigem sobreposições de janela
Desenvolvedores construindo componentes de interface flutuantes
Aplicativos que precisam de elementos persistentes na tela
Ferramentas que exigem gerenciamento de janelas de nível do sistema
Experimentação avançada de interface do usuário Android

Considerações

Limitado à plataforma Android
Requer permissões apropriadas do sistema
Pode não funcionar em todos os dispositivos devido a restrições do fabricante
Possíveis problemas de compatibilidade com versões mais recentes do Android
Requer um tratamento cuidadoso do ciclo de vida da janela e permissões

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

A Flutter plugin for manipulating Android WindowManager LayoutParams dynamically at application run-time.

Motivation

While Android natively supports a range of window modes, there was no good way to set these dynamically within a running Flutter application - instead requiring that these flags are set within the native MainActivity of the Flutter application itself.

In our App, we only wished to disable screenshots for specific screens, rather than across the entire application lifecycle. This can now be accomplished by simply calling:

await FlutterWindowManager.addFlags(FlutterWindowManager.FLAG_SECURE);

for the relevant screen.

This can further be toggled for a specific screen by either using a RouteAware mixin, or through direct toggling in initState() and dispose() methods in the case of stateful widgets.

Flags

The full range of LayoutParams flags are passed through. The plugin will carry out basic API level checking and throw an error on any unsupported flag specification. Flags are implemented using a bitmask, and may be specified individually or ORed together for setting/clearing multiple flags at once.

The current list of flags is:

FLAG_ALLOW_LOCK_WHILE_SCREEN_ON
FLAG_ALT_FOCUSABLE_IM
FLAG_DIM_BEHIND
FLAG_FORCE_NOT_FULLSCREEN
FLAG_FULLSCREEN
FLAG_HARDWARE_ACCELERATED
FLAG_IGNORE_CHEEK_PRESSES
FLAG_KEEP_SCREEN_ON
FLAG_LAYOUT_INSET_DECOR
FLAG_LAYOUT_IN_SCREEN
FLAG_LAYOUT_NO_LIMITS
FLAG_NOT_FOCUSABLE
FLAG_NOT_TOUCHABLE
FLAG_NOT_TOUCH_MODAL
FLAG_SCALED
FLAG_SECURE
FLAG_SHOW_WALLPAPER
FLAG_SPLIT_TOUCH
FLAG_WATCH_OUTSIDE_TOUCH
FLAG_BLUR_BEHIND
FLAG_DISMISS_KEYGUARD
FLAG_DITHER
FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS
FLAG_LAYOUT_ATTACHED_IN_DECOR
FLAG_LAYOUT_IN_OVERSCAN
FLAG_LOCAL_FOCUS_MODE
FLAG_SHOW_WHEN_LOCKED
FLAG_TOUCHABLE_WHEN_WAKING
FLAG_TRANSLUCENT_NAVIGATION
FLAG_TRANSLUCENT_STATUS
FLAG_TURN_SCREEN_ON

In practice, this plugin was developed primarily for the toggling of FLAG_SECURE. Other flags have not been tested, and we make no guarantees that toggling with any of the other flags will interact well with Flutter - if you find specific problems with any particular flag, please let us know in the issue tracker.

iOS Support

As flutter_windowmanager only wraps and exposes an underlying Android-specific interface, there is no iOS support planned or possible. For those interested in cross-platform FLAG_SECURE functionality, this functionality has been re-created in the third-party secure_application package. Cross-platform FLAG_KEEP_SCREEN_ON functionality is provided by the third-party keep_screen_on package.

Features and bugs

Please file feature requests and bugs at the issue tracker.

License

Licensed under the terms of the Apache 2.0 license, the full version of which can be found in the LICENSE file included in the distribution.

Buscar pacotes, repositórios e categorias de apps