Resumo
No Android, rolar uma ListView simples do Flutter posicionada sobre um ArcGISMapView (por exemplo, em uma folha inferior) resulta em uma taxa de quadros muito menor (travamentos visíveis) do que na mesma tela com o mapa removido. O mapa fica ocioso enquanto a lista rola. Em um projeto mínimo, a taxa de quadros do Flutter durante a rolagem cai de cerca de 83 fps para cerca de 22 fps em um Galaxy M14, de cerca de 105 fps para cerca de 67 fps em um Galaxy Tab S11 e de cerca de 111 fps para cerca de 78 fps em um Galaxy S25 Ultra.
No Android, ArcGISMapView usa o Hybrid Composition do Flutter (PlatformViewsService.initExpensiveAndroidView em lib/src/geo_view.dart). Gostaríamos de uma forma compatível de escolher um modo mais leve (Texture Layer, initSurfaceAndroidView).
Ambiente
arcgis_maps 300.0.0+4935 (300.1.0+5042 ainda chama initExpensiveAndroidView). Flutter 3.44.9 estável, Impeller, compilações de perfil, minSdk 30.
Dispositivos: Galaxy M14 (Exynos 1330, 90 Hz, Android 15), Galaxy S25 Ultra (120 Hz, Android 17), Galaxy Tab S11 (120 Hz, Android 16).
Reprodução mínima (não é necessária chave de API): o projeto completo (pubspec, configuração do Android) está no GitHub como getorobo/arcgis-list-jank-repro, e posso compartilhá-lo de outra forma se solicitado. Abaixo está uma versão resumida da tela: o Stack no corpo do Scaffold, em que controller é um ArcGISMapViewController e onReady define um ArcGISMap cuja basemap é uma camada de blocos do serviço público World_Imagery.
Uma tela: ArcGISMapView (blocos públicos do World_Imagery) em tela cheia, com um DraggableScrollableSheet contendo uma ListView de 100 cartões simples. Compile com MAP=true e MAP=false (o mapa é substituído por um ColoredBox) e deslize a lista repetidamente. Comandos de compilação:
flutter build apk --profile --dart-define=MAP=true --dart-define=SHEET_PCT=60 --dart-define=SHEET_MAX=60
flutter build apk --profile --dart-define=MAP=false --dart-define=SHEET_PCT=60 --dart-define=SHEET_MAX=60
// tela de reprodução resumida (lib/main.dart)
Stack(children: [
Positioned.fill(
child: kMap
? ArcGISMapView(controllerProvider: () => controller, onMapViewReady: onReady)
: const ColoredBox(color: Colors.blueGrey),
),
DraggableScrollableSheet(
initialChildSize: 0.6, minChildSize: 0.2, maxChildSize: 0.6,
builder: (context, sc) => Material(
child: ListView.builder(
controller: sc,
itemCount: 100,
itemBuilder: (context, i) => Card(
child: ListTile(
leading: const CircleAvatar(),
title: Text('Camada $i'),
subtitle: const Chip(label: Text('Camada de feições')),
trailing: IconButton.filled(onPressed: () {}, icon: const Icon(Icons.add)),
),
),
),
),
),
])
Medições
A taxa de quadros é calculada com base na própria linha do tempo do Flutter (iniciado com o extra trace-systrace, Perfetto, fatias GPURasterizer::Draw por segundo ao longo de seis deslizes consecutivos de um segundo), com três execuções por linha.
Dispositivo | Mapa visível | Mapa removido | Queda (média das execuções) |
|---|
Galaxy M14 | 19,9–24,9 fps (Draw 28–34 ms) | 83,4–83,7 fps (cerca de 3 ms) | cerca de 73% |
Galaxy Tab S11 (paisagem) | 66,3–67,0 fps (Draw 4,0–4,1 ms) | 104,1–110,4 fps (1,8 ms) | cerca de 37% |
Galaxy S25 Ultra | 76,7–79,1 fps (Draw 8,9–9,1 ms) | 107,1–115,1 fps (1,4–1,5 ms) | cerca de 30% |
O hardware de ponta mascara a maior parte do custo (cerca de 30–35% neste caso), mas não o elimina. No nosso aplicativo de produção (com uma interface Flutter mais pesada), a mesma lista sobre o mesmo mapa roda a cerca de 17–18 fps no M14.
O que os rastros mostram
Nos três dispositivos, cada quadro do Flutter é apresentado duas vezes (QueuePresentKHR, alternando superfícies ImageReader abaixo e acima da visualização da plataforma). O trabalho de rasterização do Flutter é executado na thread principal do Android e aguarda a GPU a cada quadro; em seguida, o sistema compõe o resultado novamente. No aplicativo de produção no S25, SurfaceFrame::Encode leva cerca de 3 ms por superfície, contra 0,49 ms no projeto mínimo; portanto, nesse modo, uma cena Flutter mais complexa tem seu custo duplicado a cada quadro.
O que testamos
Texture Layer: inserimos initSurfaceAndroidView em geo_view.dart por meio de um patch. No M14, no nosso aplicativo, o intervalo entre as atualizações da tela passou de cerca de 53 ms para cerca de 21 ms (medido em 2026-11-02 com gravação da tela; não medimos novamente). A renderização do mapa, o deslocamento, o zoom por pinça, o toque e a retomada continuaram funcionando em um teste rápido; não verificamos identificação de feições, edição, mapas offline, desenho, 3D nem iOS.
ARCGIS_MAPS_USE_TEXTURE=true como dart-define (opção não documentada no plug-in): melhoria semelhante, mas o uso de CPU em repouso ficou em cerca de 111–117% de um núcleo, contra cerca de 42–44%, devido à atividade contínua a cada quadro.
Flutter io.flutter.embedding.android.EnableHcpp=true em AndroidManifest.xml (Android 14+ com Vulkan; dispositivos mais antigos usam o modo alternativo): no aplicativo de produção no M14, a taxa de quadros aumentou de 16,7–18,5 fps para 37,1–38,9 fps (três execuções de cada). Custos: cerca de +80 MB de memória residente (S25), uso de CPU em repouso inalterado, sem falhas em um emulador Android 11. O Flutter documenta esse recurso como experimental, e ele não faz nada no Android 11 a 13, versões presentes nos dispositivos mais fracos.
Perguntas
(1) Existe uma forma compatível de escolher o modo de composição da visualização da plataforma no Android (por exemplo, um parâmetro em ArcGISMapView)?
(2) ARCGIS_MAPS_USE_TEXTURE é uma opção pretendida e compatível? Em caso afirmativo, é possível evitar a atividade contínua a cada quadro quando o mapa está ocioso?
(3) O Texture Layer poderia se tornar o padrão no Android? Isso está no roteiro? Ou há algum motivo conhecido para exigir Hybrid Composition (toque, teclado, acessibilidade, fidelidade de renderização)?
(4) Há algum problema conhecido com EnableHcpp e ArcGISMapView?
Os rastros do Perfetto referentes às linhas acima estão disponíveis mediante solicitação.