guava - GitLite

KO | EN

gitlite — search

#llm #gemini #pytorch #ai-agents #awesome #kubernetes #awesome-list #react-native #graphql #agent

guava

(★ 51,889)

Google core libraries for Java

파일 탐색기

ZIP 다운로드

파일 수가 많아 일부만 표시됩니다. 전체 파일은 위 다운로드 버튼으로 확인해 주세요.

- - bug_report.yaml
  - feature_addition_request.yaml
  - feature_enhancement_request.yaml
- - ci.yml
  - scorecard.yml
- dependabot.yml
- pull_request_template.md
- - maven-wrapper.properties
- - pom.xml
- - pom.xml
- - pom.xml
- - pom.xml
- pom.xml
- - pom.xml
- - pom.xml
- - pom.xml
- README.md
- module.json
- pom.xml
- pom.xml
- pom.xml
- - module-info.java
- pom.xml
- README.md
- pom.xml
.gitattributes
.gitignore
CONTRIBUTING.md
CONTRIBUTORS
cycle_suppress_list.txt
LICENSE
README.md

# 설치 가이드

java

사전 준비물

JDK 1.8 or higher
Maven

설치 및 실행 절차

mvn clean install

프로젝트를 빌드하고 로컬 Maven 저장소에 설치합니다.

핵심 명령어

mvn clean install

프로젝트의 모든 모듈을 정리하고 빌드하며 테스트를 실행합니다.

JRE 맛집은 JDK 1.8 이상이 필요하며, 안드로이드 맛집은 별도의 안드로이드 환경 설정이 필요할 수 있습니다.

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

파일 목록이 많아 일부만 표시됩니다.

링크

예시

릴리즈 타임라인

활발히 관리 중

# 프로젝트 배지

GitHub Release 바로가기
CI 바로가기
OpenSSF Best Practices 바로가기

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Guava는 Google의 핵심 Java 라이브러리 모음으로, 새로운 컬렉션 타입(multimap 및 multiset 등), 불변(immutable) 컬렉션, 그래프 라이브러리를 비롯하여 동시성, I/O, 해싱, 기본 타입(primitives), 문자열 등을 위한 유틸리티를 포함하고 있습니다! 이 라이브러리는 Google 내부의 대부분의 Java 프로젝트에서 널리 사용되며, 다른 많은 기업에서도 광범위하게 사용하고 있습니다.

Guava는 두 가지 버전(flavor)으로 제공됩니다:

*   JRE 버전은 JDK 1.8 이상이 필요합니다.
*   Android 지원이 필요한 경우, [Android 버전](https://github.com/google/guava/wiki/Android)을 사용하세요. Android용 Guava 소스는 [`android` 디렉토리]에서 찾을 수 있습니다.

[`android` 디렉토리]: https://github.com/google/guava/tree/master/android

## 빌드에 Guava 추가하기

Guava의 Maven 그룹 ID는 `com.google.guava`이고, 아티팩트 ID는 `guava`입니다.
Guava는 두 가지 다른 버전("flavor")을 제공합니다. 하나는 (Java 8+) JRE에서 사용하기 위한 것이고, 다른 하나는 Android에서 사용하거나 Android와 호환되어야 하는 모든 라이브러리에서 사용하기 위한 것입니다.
이러한 버전은 Maven 버전 필드에 `33.6.0-jre` 또는 `33.6.0-android`로 지정됩니다. Guava 의존성 추가에 대한 자세한 내용은 [빌드에서 Guava 사용하기]를 참조하세요.

Maven을 사용하여 Guava 의존성을 추가하려면 다음을 사용하세요:

```xml
<dependency>
  <groupId>com.google.guava</groupId>
  <artifactId>guava</artifactId>
  <version>33.6.0-jre</version>
  
  <version>33.6.0-android</version>
</dependency>
```

Gradle을 사용하여 의존성을 추가하려면:

```gradle
dependencies {
  // 하나를 선택하세요:

// 1. 구현(implementation)에서만 Guava 사용:
  implementation("com.google.guava:guava:33.6.0-jre")

// 2. 퍼블릭 API에서 Guava 타입 사용:
  api("com.google.guava:guava:33.6.0-jre")

// 3. Android - 구현(implementation)에서만 Guava 사용:
  implementation("com.google.guava:guava:33.6.0-android")

// 4. Android - 퍼블릭 API에서 Guava 타입 사용:
  api("com.google.guava:guava:33.6.0-android")
}
```

`api`를 사용해야 하는 시기와 `implementation`을 사용해야 하는 시기에 대한 자세한 내용은 [API 및 구현 분리에 대한 Gradle 문서](https://docs.gradle.org/current/userguide/java_library_plugin.html#sec:java_library_separation)를 참고하세요.

## 스냅샷 및 문서

`master` 브랜치에서 빌드된 Guava 스냅샷은 JRE 버전의 경우 `999.0.0-HEAD-jre-SNAPSHOT`, Android 버전의 경우 `999.0.0-HEAD-android-SNAPSHOT` 버전을 사용하여 Maven을 통해 이용할 수 있습니다.

[스냅샷 API Javadoc][guava-snapshot-api-docs] 및 [스냅샷 API Diff][guava-snapshot-api-diffs]도 이용할 수 있습니다.

Javadoc에 접근하는 또 다른 쉬운 방법은 [guava.dev/api](https://guava.dev/api)를 여는 것입니다. guava.dev 뒤에 클래스 이름을 붙여서 특정 클래스로 바로 이동할 수도 있습니다. 예를 들면 [guava.dev/ImmutableList](https://guava.dev/ImmutableList)처럼 말이죠!

## Guava에 대해 알아보기

-   사용자 가이드, [Guava 설명서 (Guava Explained)]
-   유용한 링크들의 [ 멋진 모음집](https://www.tfnico.com/presentations/google-guava)

## 링크

-   [GitHub 프로젝트](https://github.com/google/guava)
-   [이슈 트래커: 결함 보고 또는 기능 요청](https://github.com/google/guava/issues/new)
-   [StackOverflow: "어떻게 하나요?" 및 "왜 안 되나요?" 질문하기](https://stackoverflow.com/questions/ask?tags=guava+java)
-   [guava-announce: 릴리스 및 다가오는 주요 변경 사항 공지](https://groups.google.com/group/guava-announce)
-   [guava-discuss: 정해진 답이 없는 질문 및 토론을 위한 공간](https://groups.google.com/group/guava-discuss)

## 중요 경고

1.  클래스 또는 메서드 수준에서 `@Beta` 어노테이션이 표시된 API는 변경될 수 있습니다. 언제든지 어떤 방식으로든 수정되거나 심지어 제거될 수 있습니다. 작성 중인 코드가 라이브러리인 경우(즉, 사용자가 직접 제어할 수 없는 외부 사용자의 CLASSPATH에서 사용되는 경우), [재패키징]하지 않는 한 베타 API를 사용하지 않아야 합니다. **작성 중인 코드가 라이브러리인 경우, `@Beta` API를 사용하지 않도록 [Guava 베타 체커(Guava Beta Checker)]를 사용할 것을 강력히 권장합니다!**

2.  `@Beta`가 없는 API는 앞으로도 무기한 바이너리 호환성이 유지됩니다. (이전에는 지원 중단 기간이 지난 후 이러한 API를 가끔 제거하기도 했습니다. 비-`@Beta` API를 제거한 마지막 릴리스는 Guava 21.0이었습니다.) `@Deprecated`가 지정된 API도 (다시 말하지만 `@Beta`가 아닌 이상) 유지됩니다. 다시 요소를 제거하기 시작할 계획은 없지만, 만약의 상황(예: 심각한 보안 문제 등)에 대비하여 공식적으로는 가능성을 열어두고 있습니다.

3.  Guava에는 런타임 연결(linkage)에 필요한 하나의 의존성이 있습니다: `com.google.guava:failureaccess:1.0.3`. 또한 [일부 어노테이션 전용 의존성][guava-deps]도 가지고 있으며, 이는 해당 링크에서 더 자세히 다루고 있습니다.

4.  달리 명시되지 않는 한 모든 객체의 직렬화된 형태(Serialized form)는 변경될 수 있습니다. 이를 영구 저장하고 라이브러리의 향후 버전에서 읽을 수 있을 것이라고 가정하지 마세요.

5.  저희 클래스는 악의적인 호출자로부터 보호하도록 설계되지 않았습니다. 신뢰할 수 있는 코드와 신뢰할 수 없는 코드 간의 통신에 이를 사용해서는 안 됩니다.

6.  메인라인 버전의 경우, Linux 및 Windows에서 다양한 OpenJDK 버전을 사용하여 라이브러리를 테스트합니다. 일부 기능, 특히 `com.google.common.io`의 기능은 Non-Linux 환경에서 제대로 작동하지 않을 수 있습니다. Android 버전의 경우 단위 테스트도 API 레벨 24(Nougat)에서 실행됩니다.

[guava-snapshot-api-docs]: https://guava.dev/releases/snapshot-jre/api/docs/
[guava-snapshot-api-diffs]: https://guava.dev/releases/snapshot-jre/api/diffs/
[Guava Explained]: https://github.com/google/guava/wiki/Home
[Guava Beta Checker]: https://github.com/google/guava-beta-checker

[using Guava in your build]: https://github.com/google/guava/wiki/UseGuavaInYourBuild
[repackage]: https://github.com/google/guava/wiki/UseGuavaInYourBuild#what-if-i-want-to-use-beta-apis-from-a-library-that-people-use-as-a-dependency
[guava-deps]: https://github.com/google/guava/wiki/UseGuavaInYourBuild#what-about-guavas-own-dependencies