uCrop - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #ai #typescript #android #rust #docker #nodejs #java #windows #awesome #vue #pytorch #open-source

uCrop

(★ 12,082)

안드로이드용 이미지 자르기 라이브러리

파일 탐색기

최종 버전 다운로드 (.zip)

- ISSUE_TEMPLATE.md
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- .gitignore
- build.gradle
- proguard-rules.pro
- .gitignore
- build.gradle
- gradle.properties
- proguard-rules.pro
.gitattributes
.gitignore
build.gradle
gradle.properties
gradlew
gradlew.bat
jitpack.yml
mavenpush.gradle
preview.gif
preview.png
README.md
settings.gradle

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/Yalantis/uCrop

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd uCrop

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Gradle (Java/Kotlin)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java/Kotlin 프로젝트를 빌드/실행하려면 필요합니다.
Gradle 레포에 포함된 gradlew(Gradle Wrapper)를 쓰면 Gradle을 따로 설치할 필요가 없습니다.

./gradlew build

Gradle로 빌드를 진행합니다.

✅ BUILD SUCCESSFUL 메시지가 뜨면 성공입니다. build/ 폴더에 결과물이 생성됩니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# uCrop - 안드로이드용 이미지 자르기 라이브러리
#### 이 프로젝트는 최고 수준의 유연한 이미지 자르기 경험을 제공하는 것을 목표로 합니다. [Yalantis](https://yalantis.com/?utm\_source=github)에서 제작했습니다.
#### [uCrop을 만든 방법](https://yalantis.com/blog/how-we-created-ucrop-our-own-image-cropping-library-for-android/)
#### Dribbble에서 이 [프로젝트 확인하기](https://dribbble.com/shots/2484752-uCrop-Image-Cropping-Library)
![](preview.gif)
# 사용법
\*작동하는 구현 예시를 보려면 Sample Project인 sample을 참고해 주세요.\*
[![Get it on Google Play](https://play.google.com/intl/en_us/badges/images/generic/en_badge_web_generic.png)](https://play.google.com/store/apps/details?id=com.yalantis.ucrop.sample&utm_source=global_co&utm_medium=prtnr&utm_content=Mar2515&utm_campaign=PartBadge&pcampaignid=MKT-AC-global-none-all-co-pr-py-PartBadges-Oct1515-1)
1. 로컬 라이브러리 프로젝트로 라이브러리를 포함합니다.
```
allprojects {
repositories {
maven { url "https://jitpack.io" }
}
}
```
``` implementation 'com.github.yalantis:ucrop:2.2.11' ``` - 경량 일반 솔루션
``` implementation 'com.github.yalantis:ucrop:2.2.11-native' ``` - 네이티브 코드의 성능을 활용하여 이미지 품질 유지 (apk 크기 약 1.5MB 증가)
2. AndroidManifest.xml에 UCropActivity를 추가합니다.
```
```
3. uCrop 결과에 대한 콜백을 등록합니다.
```java
private ActivityResultLauncher activityResultLauncher =
registerForActivityResult(new ActivityResultContracts.StartActivityForResult(), result -> {
if (result.getResultCode() == RESULT\_OK) {
final Uri resultUri = UCrop.getOutput(result.getData());
} else if (result.getResultCode() == UCrop.RESULT\_ERROR) {
final Throwable cropError = UCrop.getError(result.getData());
}
});
```
4. 빌더 패턴을 사용하여 uCrop 구성을 생성합니다.
```java
UCrop.of(sourceUri, destinationUri)
.withAspectRatio(16, 9)
.withMaxResultSize(maxWidth, maxHeight)
.start(context, activityResultLauncher);
```
5. PROGUARD 설정에 다음을 추가해야 할 수 있습니다.
```
-dontwarn com.yalantis.ucrop\*\*
-keep class com.yalantis.ucrop\*\* { \*; }
-keep interface com.yalantis.ucrop\*\* { \*; }
```
# 커스텀
사용자가 자르기 비율을 동적으로 선택하도록 하려면 `withAspectRatio(x, y)`를 호출하지 않으면 됩니다.
uCrop 빌더 클래스에는 라이브러리 구성을 확장하는 `withOptions(UCrop.Options options)` 메서드가 있습니다.
현재 변경할 수 있는 항목은 다음과 같습니다.
\* 이미지 압축 형식 (예: PNG, JPEG), 압축
\* 이미지 압축 품질 [0 - 100]. 무손실 형식인 PNG는 품질 설정을 무시합니다.
\* 모든 제스처를 동시에 활성화할지 여부
\* 소스 Uri에서 디코딩되고 자르기 뷰 내에서 사용되는 Bitmap의 최대 크기. 기본 동작을 재정의하려는 경우 사용합니다.
\* 자르기 프레임/가이드라인 표시 여부 토글
\* 자르기 프레임/행/열의 색상/너비/개수 설정
\* 직사각형 또는 타원형(`options.setCircleDimmedLayer(true)`) 자르기 영역 선택
\* UI 색상 (Toolbar, StatusBar, 활성 위젯 상태)
\* 기타 기능...
# 호환성
\* 라이브러리 - Android Lollipop 5.0+ (API 21) (버전 2.2.11 미만의 경우 Android ICS 4.0+ (API 14))
\* 샘플 - Android Lollipop 5.0+ (API 21)
\* CPU - armeabi-v7a x86 x86\_64 arm64-v8a (버전 2.2.11 이상 기준)
# 변경 로그
### 버전: 2.2.11
\* compileSdk 및 targetSdk를 36으로 업데이트
\* 16 KB 페이지 크기 지원 추가
\* 엣지 투 엣지(Edge-to-edge) UI 지원 활성화
\* 기타 개선 사항
### 버전: 2.2.10
\* [#926](https://github.com/Yalantis/uCrop/issues/926) 수정
### 버전: 2.2.9
\* compileSdk 및 targetSdk 버전을 33까지 업데이트
\* [#867](https://github.com/Yalantis/uCrop/issues/867) 수정
\* [#873](https://github.com/Yalantis/uCrop/issues/873) 수정
\* 기타 개선 사항
### 버전: 2.2.8
\* 개선 사항 및 버그 수정이 포함된 대기 중인 풀 리퀘스트 병합
\* compileSdk 및 targetSdk 버전을 31까지 업데이트
\* 현지화 추가
\* [#609](https://github.com/Yalantis/uCrop/issues/609) 수정
\* [#794](https://github.com/Yalantis/uCrop/issues/794) 수정
### 버전: 2.2.5
\* [#584](https://github

.com/Yalantis/uCrop/issues/584)
\* 수정됨 [#598](https://github.com/Yalantis/uCrop/issues/598)
\* 수정됨 [#543](https://github.com/Yalantis/uCrop/issues/543)
\* 수정됨 [#602](https://github.com/Yalantis/uCrop/issues/602)
\* 기타 개선 사항
### Version: 2.2.4
\* \*\*AndroidX 마이그레이션\*\*
\* 리디자인
\* [#550](https://github.com/Yalantis/uCrop/issues/550)을 비롯한 여러 버그 수정
### Version: 2.2.3
\* [#445](https://github.com/Yalantis/uCrop/issues/445), [#465](https://github.com/Yalantis/uCrop/issues/465) 등을 비롯한 여러 버그 수정!
\* Material Design 지원
\* 자식 프래그먼트로서의 uCrop 프래그먼트 지원
\* 이탈리아어 추가
### Version: 2.2.2
\* uCrop 프래그먼트 추가
\* 버그 수정
### Version: 2.2.1
\* [#285](https://github.com/Yalantis/uCrop/issues/285) 포함 수정
### Version: 2.2
\* [#121](https://github.com/Yalantis/uCrop/issues/121), [#173](https://github.com/Yalantis/uCrop/issues/173), [#184](https://github.com/Yalantis/uCrop/issues/184) 등을 비롯한 여러 버그 수정!
\* 새로운 API 도입: [#149](https://github.com/Yalantis/uCrop/issues/149), [#186](https://github.com/Yalantis/uCrop/issues/186), [#156](https://github.com/Yalantis/uCrop/issues/156)
### Version: 2.1
\* EXIF 데이터 관련 문제 수정 (주로 삼성 기기의 전면 카메라로 촬영한 이미지) [#130](https://github.com/Yalantis/uCrop/issues/130) [#111](https://github.com/Yalantis/uCrop/issues/111)
\* 사용자가 사용자 정의 종횡비 옵션 세트를 설정할 수 있는 API 추가 [#131](https://github.com/Yalantis/uCrop/issues/131)
\* UCrop.Options 클래스를 통해 모든 설정을 지정할 수 있는 API 추가 [#126](https://github.com/Yalantis/uCrop/issues/126)
\* ABI x86\_64 지원 추가 [#105](https://github.com/Yalantis/uCrop/issues/105)
### Version: 2.0
\* 네이티브 이미지 자르기 (고해상도 이미지 자르기 가능, 예: Nexus 5X에서의 16MP 및 32MP 이미지).
\* WebP 압축 형식은 현재 지원되지 않습니다 (JPEG 또는 PNG를 선택하세요).
\* 이제 라이브러리가 EXIF 데이터를 자른 이미지에 복사합니다 (크기 및 방향이 업데이트됨).
### Version: 1.5
\* "Freestyle" 자르기 도입 (모서리를 드래그하여 자르기 사각형의 크기를 조절할 수 있음) [#32](https://github.com/Yalantis/uCrop/issues/32)
\* 이제 이미지와 자르기 뷰의 패딩이 서로 연동되지 않음 [#68](https://github.com/Yalantis/uCrop/issues/68)
\* API 업데이트
### Version: 1.4
\* HTTP(s) Uri 지원 도입!
\* 이미지가 백그라운드 스레드에서 잘립니다.
\* Bitmap이 처리되는 동안 로더 표시 (로드 및 자르기 모두).
\* 여러 버그 수정.
\* 설정할 수 있는 몇 가지 새로운 항목 추가.
\* minSdkVersion을 Android ICS 4.0으로 업데이트 (소수의 오래된 폰 사용자를 지원할 이유가 없음).
### Version: 1.3
\* 이미지가 백그라운드 스레드에서 로드됩니다. 이미지 디코딩을 위한 더 나은 오류 처리.
\* EXIF 데이터 지원 향상 (회전 및 대칭).
\* 소소한 UI 업데이트.
\* 설정할 수 있는 몇 가지 새로운 항목 추가.
\* 사용자 정의 종횡비를 선택할 수 있는 기능이 포함된 샘플 업데이트.
### Version: 1.2
\* 핵심 로직이 업데이트되어 이미지가 부드럽고 명확하게 위치를 보정합니다.
### Version: 1.1
\* UCrop 빌더가 업데이트되었으며 이제 UCrop.Options 클래스에서 설정할 수 있는 값이 더 많아졌습니다.
### Version: 1.0
\* 초기 빌드
### 알려주세요!
저희 컴포넌트를 사용하는 프로젝트의 링크를 보내주시면 정말 기쁠 것입니다. github@yalantis.com으로 이메일을 보내주세요. 그리고 라이브러리와 관련된 질문이나 제언이 있다면 언제든지 알려주세요.
#### uCrop을 사용하는 앱
- [Thirty](https://play.google.com/store/apps/details?id=com.twominds.thirty).
- [Light Smart HD](https://play.google.com/store/apps/details?id=com.SmartCamera.simple).
- [BCReader](https://play.google.com/store/apps/details?id=com.iac.bcreader).
- [Xprezia: Share Your Passion](https://play.google.com/store/apps/details?id=com.xprezzia.cnj).
## License
Copyright 2017, Yalantis
Software doesn't collect, store or transfer data to Yalantis or third parties.
Emplacement of this Software is carried out locally at device.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the Li

cense.
다음 라이선스 사본을 얻을 수 있습니다:
http://www.apache.org/licenses/LICENSE-2.0
관련 법률에 의해 요구되거나 서면으로 합의되지 않는 한, 본 라이선스에 따라 배포되는 소프트웨어는 어떠한 명시적이거나 묵시적인 보증이나 조건 없이 "있는 그대로(AS IS)" 배포됩니다.
라이선스에 따른 허가 사항과 제한 사항을 규정하는 구체적인 언어는 라이선스를 참조하십시오.