{"id":3655,"url":"https://github.com/google/guava","last_synced_at":"2025-09-09T21:11:01.193Z","repository":{"id":17512239,"uuid":"20300177","full_name":"google/guava","owner":"google","description":"Google core libraries for Java","archived":false,"fork":false,"pushed_at":"2025-05-12T16:22:11.000Z","size":558811,"stargazers_count":50754,"open_issues_count":714,"forks_count":10986,"subscribers_count":2364,"default_branch":"master","last_synced_at":"2025-05-12T17:34:03.560Z","etag":null,"topics":["guava","java"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/google.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2014-05-29T16:23:17.000Z","updated_at":"2025-05-12T15:58:15.000Z","dependencies_parsed_at":"2024-02-19T16:45:55.564Z","dependency_job_id":"7e87d230-faa0-43db-9ff5-55b078855267","html_url":"https://github.com/google/guava","commit_stats":{"total_commits":6662,"total_committers":466,"mean_commits":"14.296137339055795","dds":0.6975382767937557,"last_synced_commit":"2f04514087a61201dc477ecf9c4f078ec14698a9"},"previous_names":[],"tags_count":119,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google%2Fguava","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google%2Fguava/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google%2Fguava/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google%2Fguava/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/google","download_url":"https://codeload.github.com/google/guava/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253789267,"owners_count":21964648,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["guava","java"],"created_at":"2024-01-05T20:16:47.654Z","updated_at":"2025-09-09T21:11:01.164Z","avatar_url":"https://github.com/google.png","language":"Java","readme":"# Guava: Google Core Libraries for Java\n\n[![GitHub Release](https://img.shields.io/github/v/release/google/guava)](https://github.com/google/guava/releases/latest)\n[![CI](https://github.com/google/guava/actions/workflows/ci.yml/badge.svg)](https://github.com/google/guava/actions/workflows/ci.yml)\n[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/7197/badge)](https://www.bestpractices.dev/projects/7197)\n\n\n\nGuava is a set of core Java libraries from Google that includes new collection\ntypes (such as multimap and multiset), immutable collections, a graph library,\nand utilities for concurrency, I/O, hashing, primitives, strings, and more! It\nis widely used on most Java projects within Google, and widely used by many\nother companies as well.\n\n\n\nGuava comes in two flavors:\n\n*   The JRE flavor requires JDK 1.8 or higher.\n*   If you need support for Android, use\n    [the Android flavor](https://github.com/google/guava/wiki/Android). You can\n    find the Android Guava source in the [`android` directory].\n\n[`android` directory]: https://github.com/google/guava/tree/master/android\n\n## Adding Guava to your build\n\nGuava's Maven group ID is `com.google.guava`, and its artifact ID is `guava`.\nGuava provides two different \"flavors\": one for use on a (Java 8+) JRE and one\nfor use on Android or by any library that wants to be compatible with Android.\nThese flavors are specified in the Maven version field as either `33.4.8-jre` or\n`33.4.8-android`. For more about depending on Guava, see\n[using Guava in your build].\n\nTo add a dependency on Guava using Maven, use the following:\n\n```xml\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.google.guava\u003c/groupId\u003e\n  \u003cartifactId\u003eguava\u003c/artifactId\u003e\n  \u003cversion\u003e33.4.8-jre\u003c/version\u003e\n  \u003c!-- or, for Android: --\u003e\n  \u003cversion\u003e33.4.8-android\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\nTo add a dependency using Gradle:\n\n```gradle\ndependencies {\n  // Pick one:\n\n  // 1. Use Guava in your implementation only:\n  implementation(\"com.google.guava:guava:33.4.8-jre\")\n\n  // 2. Use Guava types in your public API:\n  api(\"com.google.guava:guava:33.4.8-jre\")\n\n  // 3. Android - Use Guava in your implementation only:\n  implementation(\"com.google.guava:guava:33.4.8-android\")\n\n  // 4. Android - Use Guava types in your public API:\n  api(\"com.google.guava:guava:33.4.8-android\")\n}\n```\n\nFor more information on when to use `api` and when to use `implementation`,\nconsult the\n[Gradle documentation on API and implementation separation](https://docs.gradle.org/current/userguide/java_library_plugin.html#sec:java_library_separation).\n\n## Snapshots and Documentation\n\nSnapshots of Guava built from the `master` branch are available through Maven\nusing version `999.0.0-HEAD-jre-SNAPSHOT`, or `999.0.0-HEAD-android-SNAPSHOT`\nfor the Android flavor.\n\n[Snapshot API Javadoc][guava-snapshot-api-docs] as well as\n[Snapshot API Diffs][guava-snapshot-api-diffs] are also available.\n\nAnother easy way to get to the Javadoc is to open\n[guava.dev/api](https://guava.dev/api). You can also jump right to a specific\nclass by appending the class name to guava.dev. For example,\n[guava.dev/ImmutableList](https://guava.dev/ImmutableList)!\n\n## Learn about Guava\n\n-   Our users' guide, [Guava Explained]\n-   [A nice collection](https://www.tfnico.com/presentations/google-guava) of\n    other helpful links\n\n## Links\n\n-   [GitHub project](https://github.com/google/guava)\n-   [Issue tracker: Report a defect or feature request](https://github.com/google/guava/issues/new)\n-   [StackOverflow: Ask \"how-to\" and \"why-didn't-it-work\" questions](https://stackoverflow.com/questions/ask?tags=guava+java)\n-   [guava-announce: Announcements of releases and upcoming significant changes](https://groups.google.com/group/guava-announce)\n-   [guava-discuss: For open-ended questions and discussion](https://groups.google.com/group/guava-discuss)\n\n## IMPORTANT WARNINGS\n\n1.  APIs marked with the `@Beta` annotation at the class or method level are\n    subject to change. They can be modified in any way, or even removed, at any\n    time. If your code is a library itself (i.e., it is used on the CLASSPATH of\n    users outside your own control), you should not use beta APIs unless you\n    [repackage] them. **If your code is a library, we strongly recommend using\n    the [Guava Beta Checker] to ensure that you do not use any `@Beta` APIs!**\n\n2.  APIs without `@Beta` will remain binary-compatible for the indefinite\n    future. (Previously, we sometimes removed such APIs after a deprecation\n    period. The last release to remove non-`@Beta` APIs was Guava 21.0.) Even\n    `@Deprecated` APIs will remain (again, unless they are `@Beta`). We have no\n    plans to start removing things again, but officially, we're leaving our\n    options open in case of surprises (like, say, a serious security problem).\n\n3.  Guava has one dependency that is needed for linkage at runtime:\n    `com.google.guava:failureaccess:1.0.3`. It also has\n    [some annotation-only dependencies][guava-deps], which we discuss in more\n    detail at that link.\n\n4.  Serialized forms of ALL objects are subject to change unless noted\n    otherwise. Do not persist these and assume they can be read by a future\n    version of the library.\n\n5.  Our classes are not designed to protect against a malicious caller. You\n    should not use them for communication between trusted and untrusted code.\n\n6.  For the mainline flavor, we test the libraries using OpenJDK 8, 11, and 17\n    on Linux, with some additional testing on newer JDKs and on Windows. Some\n    features, especially in `com.google.common.io`, may not work correctly in\n    non-Linux environments. For the Android flavor, our unit tests also run on\n    API level 23 (Marshmallow).\n\n[guava-snapshot-api-docs]: https://guava.dev/releases/snapshot-jre/api/docs/\n[guava-snapshot-api-diffs]: https://guava.dev/releases/snapshot-jre/api/diffs/\n[Guava Explained]: https://github.com/google/guava/wiki/Home\n[Guava Beta Checker]: https://github.com/google/guava-beta-checker\n\n\u003c!-- References --\u003e\n\n[using Guava in your build]: https://github.com/google/guava/wiki/UseGuavaInYourBuild\n[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\n[guava-deps]: https://github.com/google/guava/wiki/UseGuavaInYourBuild#what-about-guavas-own-dependencies\n","funding_links":[],"categories":["Java Tools, Libraries, and Frameworks","Tools","Java Tools and Frameworks","Java Tools","语言篇","Java","Libraries","Java Tools \u0026 Frameworks","HarmonyOS","Projects","Awesome-Java [![awesome-go-Status-Image](https://travis-ci.org/avelino/awesome-go.svg?branch=master)](https://travis-ci.org/avelino/awesome-go) [![996.icu](https://img.shields.io/badge/link-996.icu-red.svg)](https://996.icu)","Tool","常用框架\\\u0026第三方库","Java 程序设计","Utility Libraries","[Programming]","Java (78)","Utility","dependency list","项目","工具集","Awesome Tools","I. Development","库","工具库","Technologies we used in the Microservices","General-purpose libraries","\u003ca name=\"Java\"\u003e\u003c/a\u003eJava","Solutions"],"sub_categories":["Interfaces","VS Code Extensions for Developer Productivity","E-Books","Objective-C Tools, Libraries, and Frameworks","JavaScript Libraries for Machine Learning","Mesh networks","Java","Other","In-memory data grids","Windows Manager","Utility","Common Utils/Code Quality","网络服务_其他","Utilities","[Programming] - [Java]","实用程序","计算机基础-java","Languages","1. Common frameworks and libraries","实用工具","Core Libraries","[](https://github.com/JStumpp/awesome-android/blob/master/readme.md#other)其他","Core Java Libraries"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogle%2Fguava","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoogle%2Fguava","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogle%2Fguava/lists"}