Flutter에서 SVG (스케일러블 벡터 그래픽)를 처리하는 데 사용되는 flutter_svg 라이브러리는 강력하고 유연한 기능을 제공합니다. 이 라이브러리를 사용하는 방법에 대한 API 문서와 사용 가이드라인은 다음과 같습니다.

API 문서

flutter_svg 라이브러리의 API 문서는 다음과 같은 중요한 클래스와 기능을 포함합니다.

1. SvgPicture 클래스

이 클래스는 SVG 파일을 로드하고 표시하는 데 사용됩니다. SvgPicture.asset, SvgPicture.network, SvgPicture.file과 같은 생성자를 통해 SVG 이미지를 로드하고 표시할 수 있습니다.

예시:

SvgPicture.asset(
  'assets/image.svg',
  semanticsLabel: 'An SVG picture',
);

2. SvgPicture.network

이 클래스는 네트워크에서 SVG 파일을 가져와 로드하는 데 사용됩니다.

예시:

SvgPicture.network(
  'https://example.com/image.svg',
  semanticsLabel: 'An SVG picture',
);

3. SvgPicture.file

이 클래스는 로컬 파일 시스템에서 SVG 파일을 가져와 로드하는 데 사용됩니다.

예시:

SvgPicture.file(
  File('path/image.svg'),
  semanticsLabel: 'An SVG picture',
);

사용 가이드라인

flutter_svg 라이브러리를 사용할 때 다음 가이드라인을 따르는 것이 좋습니다.

1. SVG 파일은 assets 폴더에 추가되어야 하며, pubspec.yaml 파일에 해당 폴더가 포함되어야 합니다.
2. SvgPicture 위젯을 사용하여 SVG를 표시할 때 semanticsLabel을 명시적으로 제공하여 화면 낭독기가 이미지를 설명할 수 있도록 합니다.
3. SVG 이미지의 크기 및 화면 배치를 제어하기 위해 fit 및 alignment 속성을 활용합니다.

이러한 가이드라인을 준수하면 flutter_svg 라이브러리를 효과적으로 활용할 수 있습니다.

더 자세한 정보는 flutter_svg 공식 문서를 참조하세요.