한국어는 runchr 제공 번역입니다. 원문 README는 English tool page.
LetterAvatarKit
LetterAvatarKit은 iOS용으로 결정론적인 문자 기반 아바타와 플레이스홀더를 생성하기 위한 UIImage 확장 및 빌더 API를 제공하는 Swift 프레임워크입니다.
- Install
- pod "LetterAvatarKit" or add https://github.com/vpeschenkov/LetterAvatarKit via Swift Package Manager
프로젝트 README (번역)
GitHub ↗Written by the project's own authors, not by runchr. Snapshot taken 2026-10-31.
LetterAvatarKit
LetterAvatarKit은 글자 기반 아바타/플레이스홀더를 생성하기 위한 UIImage 확장을 제공합니다. 이 프레임워크를 사용하여 달성할 수 있는 결과를 보여주는 몇 가지 이미지가 있습니다:
요구 사항
iOS 12+
tvOS 12+
Swift 5.9+
기능
사용하기 쉽고 직관적인 인터페이스
다양한 프로젝트에 맞춤화 및 통합이 가능한 매우 유연한 API
아바타 구성을 구축하기 위한 빌더 패턴 사용
원형, 정사각형 또는 테두리가 있는 이미지 생성 지원
다양한 플랫 UI 색상 제공
tvOS 플랫폼과 호환
설치
CocoaPods
LetterAvatarKit은 CocoaPods 를 통해 사용할 수 있습니다. 설치하려면
Podfile에 다음 줄을 추가하기만 하면 됩니다:
pod "LetterAvatarKit"
Swift Package Manager
Xcode에서 https://github.com/vpeschenkov/LetterAvatarKit 을 패키지 종속성으로 추가하세요.
사용법
Swift
LetterAvatarMaker 사용:
// 정사각형 아바타 이미지
let avatarImage = LetterAvatarMaker ( )
. setUsername ( " Letter Avatar " )
. build ( )
avatarImageView . image = avatarImage
// 흰색 테두리가 있는 원형 아바타 이미지
let circleAvatarImage = LetterAvatarMaker ( )
. setCircle ( true )
. setUsername ( " Letter Avatar " )
. setBorderWidth ( 1.0 )
. setBackgroundColors ( [ . red ] )
. build ( )
avatarImageView . image = circleAvatarImage
// 파생된 이니셜 대신 명시적 텍스트가 있는 아바타 이미지
let customTextAvatarImage = LetterAvatarMaker ( )
. setUsername ( " +19 " )
. setLetters ( " +19 " )
. build ( )
avatarImageView . image = customTextAvatarImage
클로저와 함께 LetterAvatarMaker 사용:
let avatarImage = LetterAvatarMaker ( )
. build { c in
c . username = " Letter Avatar "
}
avatarImageView . image = avatarImage
let avatarImage = LetterAvatarMaker ( )
. build { c in
c . circle = true
c . username = " Letter Avatar "
c . borderWidth = 1.0
c . backgroundColors = [ . red ]
}
avatarImageView . image = avatarImage
LetterAvatarBuilderConfiguration 사용:
let configuration = LetterAvatarBuilderConfiguration ( )
configuration . username = " Letter Avatar "
avatarImageView . image = UIImage . makeLetterAvatar ( configuration : configuration )
UIImage 확장 사용:
avatarImageView . image = UIImage . makeLetterAvatar ( username : " Letter Avatar " )
맞춤화
LetterAvatarBuilderConfiguration 의 다음 속성을 구성할 수 있습니다:
/// 사용자 이름.
open var username : String ?
/// 사용자 이름에서 파생하는 대신 그려야 하는 글자.
open var letters : String ?
/// 아바타 이미지의 크기.
open var size : CGSize = CGSize ( width : 80 , height : 80 )
/// 하나의 글자만 사용할지 여부를 나타내는 플래그, 그렇지 않으면
/// 가능한 한 많이 얻을 수 있습니다. 단, 3글자를 초과하지 않습니다.
open var useSingleLetter : Bool = false
/// 글자 폰트.
open var lettersFont : UIFont ?
/// 글자 색상
open var lettersColor : UIColor = LKUIColorByRGB ( red : 236 , green : 240 , blue : 241 )
/// 이미지의 배경 색상.
open var backgroundColors : [ UIColor ] = UIColor . colors
/// 글자 폰트 속성.
open var lettersFontAttributes : [ NSAttributedString . Key : Any ] ?
/// 원형 또는 정사각형 이미지를 생성할지 여부를 나타냅니다.
open var circle : Bool = false
/// 이미지의 테두리 너비.
open var borderWidth : CGFloat = 0.0
/// 이미지의 테두리 색상.
open var borderColor : UIColor = UIColor . white
/// 아바타가 불투명한지 여부를 나타내는 부울 플래그.
open var isOpaque : Bool = false
커뮤니티
질문, 의견, 이슈 및 풀 리퀘스트를 환영합니다!
연락처
GitHub
Twitter
라이선스
MIT 라이선스에 따라 배포됩니다. 자세한 내용은 LICENSE를 참조하세요.
No comments yet.
to comment.