screen_capturer

Instalar pacote

flutter pub add screen_capturer

Visão geral do pacote

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

O pacote screen_capturer permite aplicativos desktop do Flutter capturar telas no macOS, Windows e Linux. Ele fornece uma API simples para tirar capturas de tela da tela inteira ou de regiões específicas, sendo ideal para aplicativos que exigem documentação visual, ferramentas de depuração ou recursos de compartilhamento de tela. O plugin se integra diretamente às capacidades nativas de captura de tela do sistema operacional, garantindo desempenho confiável em todas as plataformas. É projetado para desenvolvedores que constroem aplicativos desktop-first com Flutter e precisam interagir programaticamente com o conteúdo da tela.

Casos de uso

Tirando capturas de tela em aplicativos para desktop
Ferramentas de depuração e teste
Utilitários de gravação de tela
Documentação visual
Percursos pela interface do usuário

Principais recursos

Suporte multiplataforma (macOS, Windows, Linux)
API de captura de tela simples
Captura específica por região
Integração com sistema operacional nativo
Leve e rápido

Indicado para

Desenvolvedores de aplicativos para desktop
Criadores de ferramentas de depuração
testes de automação de UI
Aplicativos de compartilhamento de tela

Considerações

Requer permissões específicas da plataforma
Limitado a plataformas de desktop
Pode exigir consentimento do usuário para acesso à tela
Sem suporte a dispositivos móveis
Depende de APIs do sistema nativo

README original

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

🚀 Ship Your App Faster: Try Fastforge - The simplest way to build, package and distribute your Flutter apps.

This plugin allows Flutter desktop apps to take screenshots.

English | 简体中文

screen_capturer

Platform Support

Linux	macOS	Windows
✔️	✔️	✔️

Quick Start

Installation

Add this to your package's pubspec.yaml file:

dependencies:
  screen_capturer: ^0.2.3

Or

dependencies:
  screen_capturer:
    git:
      path: packages/screen_capturer
      url: https://github.com/leanflutter/screen_capturer.git
      ref: main

Windows requirements

Be sure to modify your Visual Studio installation and ensure that "C++ ATL for latest v142 build tools (x86 & x64)" is installed!

Usage

macOS

Change the file macos/Runner/DebugProfile.entitlements or macos/Runner/Release.entitlements as follows:

Required only for sandbox mode.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>com.apple.security.app-sandbox</key>
	<true/>
+	<key>com.apple.security.temporary-exception.mach-register.global-name</key>
+	<string>com.apple.screencapture.interactive</string>
</dict>
</plist>

import 'package:screen_capturer/screen_capturer.dart';

CapturedData? capturedData = await screenCapturer.capture(
  mode: CaptureMode.region, // screen, window
  imagePath: '<path>',
  copyToClipboard: true,
);

Please see the example app of this plugin for a full example.

Platform Differences

CaptureMode

Name	Description	Linux	macOS	Windows
`region`	Drag the cursor around an object to form a rectangle.	✔️	✔️	✔️
`screen`	Capture the entire screen.	✔️	✔️	✔️
`window`	Select a window, that you want to capture. (linux capture only the current window)	➖	✔️	✔️