Buscar pacotes, repositórios e categorias de apps

ducafecatGuia do ecossistema Flutter
Detalhes do pacotev1.1.0+3

fps_jank_flash_widget

Um widget do Flutter que pisca quando o Flutter falha em renderizar um quadro dentro de um determinado período de tempo.

AndroidiOSWebmacOSWindowsLinux
pub.dev Documentação da API Código-fonte
Downloads em 30 dias
8
Curtidas
22
Pontos Pub
160

Instalar pacote

flutter pub add fps_jank_flash_widget

Visão geral do pacote

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

O fps_jank_flash_widget é uma ferramenta de monitoramento de desempenho do Flutter que pisca visualmente quando o aplicativo falha em renderizar quadros dentro de um tempo especificado. Projetado para desenvolvedores, ajuda a identificar gargalos de renderização destacando momentos de interface com problemas de resposta ou instabilidade em tempo real. O widget se integra perfeitamente em todas as principais plataformas — Android, iOS, Web, macOS, Windows e Linux — tornando-se útil durante o desenvolvimento e testes. É particularmente eficaz para diagnosticar quedas de quadros e otimizar animações ou layouts complexos.

Casos de uso

  • Depuração de desempenho em tempo real
  • Identificando travamentos na interface durante animação
  • Testando a responsividade do aplicativo em diferentes dispositivos
  • Otimização de árvores de widgets complexas
  • Monitoramento da consistência da taxa de quadros

Principais recursos

  • Indicador visual de flash para quadros perdidos
  • Compatibilidade multiplataforma
  • Limite configurável para detecção de travamento
  • Configuração mínima com pub add
  • Feedback em tempo de execução sem ferramentas adicionais

Indicado para

  • Desenvolvedores Flutter resolvendo problemas de desempenho
  • Equipes focadas em experiências de interface suave
  • Testadores de aplicativos validando a estabilidade da taxa de quadros
  • Uso educacional para aprender sobre renderização de quadros

Considerações

  • Não recomendado para builds de produção
  • Pode causar distração durante testes com usuários
  • Requer ativação manual
  • Limitado a feedback visual apenas
  • Sobrecarga de desempenho em cenários de alta frequência

README original

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

FPS Jank Flash widget

A flutter widget that flashes when flutter fails to render a frame in a certain timeframe

lesnitsky.dev GitHub stars Twitter Follow

Installation

flutter pub add fps_jank_flash_widget
flutter packages get

Usage

import 'package:fps_jank_flash_widget/fps_jank_flash_widget.dart';

void main() {
  const frameBudget = Duration(milliseconds: 17); // 60 fps
  FPSJankFlash.frameBudget = frameBudget;

  runApp(FPSJankFlash.overlay(child: const MyApp()));
}

FPSJankFlash could be used directly:

import 'package:fps_jank_flash_widget/fps_jank_flash_widget.dart';

class SomeWidget extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Stack(
      children: [
        Column(
         children: [
            /// ... your widgets,
          ],
        ),
        const FPSJankFlash(),
      ]
    );
  }
}

You can also use a JankObserver:

import 'package:fps_jank_flash_widget/fps_jank_flash_widget.dart';

void main() {
  JankObserver.addListener(() {
    print('jank detected');
  });

  runApp(YourApp());
}

If you're testing the app on a higher refresh rate displays, override the frame duration budget:

import 'package:fps_jank_flash_widget/fps_jank_flash_widget.dart';


void main() {
  const refreshRate = 120;
  final budgetMs = 1000 ~/ refreshRate;
  FPSJankFlash.frameBudget = Duration(milliseconds: budgetMs);

  runApp(FPSJankFlash.overlay(child: const MyApp()));
}

License

MIT

lesnitsky.dev GitHub stars Twitter Follow

Categorias

Insights de Desempenho e Crashes

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.