image_gallery_saver

Visão geral do pacote

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

O pacote image_gallery_saver é um plugin Flutter que permite salvar imagens na galeria do dispositivo tanto no Android quanto no iOS. Ele fornece uma API simples para armazenar dados em bytes ou caminhos de arquivos como imagens na biblioteca de fotos do sistema. No iOS, os usuários devem adicionar chaves específicas ao arquivo Info.plist para conceder permissões de acesso. Este plugin é ideal para aplicativos que geram ou baixam imagens e precisam oferecer um recurso de 'salvar na galeria'. Ele suporta arquivos locais e dados brutos de imagem, tornando-o flexível para vários casos de uso.

Casos de uso

Salvando capturas de tela capturadas
Armazenando arte gerada
Exportando imagens criadas pelo usuário
Compartilhando imagens do conteúdo do aplicativo
Salvando mídia baixada

Principais recursos

API de salvamento simples
Suporta Android e iOS
Manipula dados de bytes e caminhos de arquivos
Requer configuração de Info.plist no iOS
Compatibilidade multiplataforma

Indicado para

Aplicativos de edição de imagem
Ferramentas de compartilhamento em redes sociais
utilitários de geração de fotos
Aplicativos com conteúdo gerado pelo usuário
Ferramentas que exigem armazenamento offline de imagens

Considerações

O iOS exige entradas no Info.plist
As permissões podem variar conforme a plataforma
Arquivos grandes podem afetar o desempenho
Opções limitadas de personalização
Sem feedback de progresso embutido

README original

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

We use the image_picker plugin to select images from the Android and iOS image library, but it can't save images to the gallery. This plugin can provide this feature.

Usage

To use this plugin, add image_gallery_saver as a dependency in your pubspec.yaml file. For example:

dependencies:
  image_gallery_saver: '^2.0.3'

iOS

Your project need create with swift. Add the following keys to your Info.plist file, located in /ios/Runner/Info.plist:

NSPhotoLibraryAddUsageDescription - describe why your app needs permission for the photo library. This is called Privacy - Photo Library Additions Usage Description in the visual editor

Android

You need to ask for storage permission to save an image to the gallery. You can handle the storage permission using flutter_permission_handler. In Android version 10, Open the manifest file and add this line to your application tag

<application android:requestLegacyExternalStorage="true" .....>

Example

Saving an image from the internet, quality and name is option

  _saveLocalImage() async {
    RenderRepaintBoundary boundary =
        _globalKey.currentContext!.findRenderObject() as RenderRepaintBoundary;
    ui.Image image = await boundary.toImage();
    ByteData? byteData =
        await (image.toByteData(format: ui.ImageByteFormat.png));
    if (byteData != null) {
      final result =
          await ImageGallerySaver.saveImage(byteData.buffer.asUint8List());
      print(result);
    }
  }
  
  _saveNetworkImage() async {
    var response = await Dio().get(
        "https://ss0.baidu.com/94o3dSag_xI4khGko9WTAnF6hhy/image/h%3D300/sign=a62e824376d98d1069d40a31113eb807/838ba61ea8d3fd1fc9c7b6853a4e251f94ca5f46.jpg",
        options: Options(responseType: ResponseType.bytes));
    final result = await ImageGallerySaver.saveImage(
        Uint8List.fromList(response.data),
        quality: 60,
        name: "hello");
    print(result);
  }

Saving file(ig: video/gif/others) from the internet

  _saveNetworkGifFile() async {
    var appDocDir = await getTemporaryDirectory();
    String savePath = appDocDir.path + "/temp.gif";
    String fileUrl =
        "https://hyjdoc.oss-cn-beijing.aliyuncs.com/hyj-doc-flutter-demo-run.gif";
    await Dio().download(fileUrl, savePath);
    final result =
        await ImageGallerySaver.saveFile(savePath, isReturnPathOfIOS: true);
    print(result);
  }

  _saveNetworkVideoFile() async {
    var appDocDir = await getTemporaryDirectory();
    String savePath = appDocDir.path + "/temp.mp4";
    String fileUrl =
        "https://s3.cn-north-1.amazonaws.com.cn/mtab.kezaihui.com/video/ForBiggerBlazes.mp4";
    await Dio().download(fileUrl, savePath, onReceiveProgress: (count, total) {
      print((count / total * 100).toStringAsFixed(0) + "%");
    });
    final result = await ImageGallerySaver.saveFile(savePath);
    print(result);
  }