{"id":19924385,"url":"https://github.com/kontent-ai/java-packages","last_synced_at":"2026-01-11T17:35:58.774Z","repository":{"id":37239943,"uuid":"100407794","full_name":"kontent-ai/java-packages","owner":"kontent-ai","description":"Delivery Java SDK for Kontent.ai including examples for Spring, Gradle, Kotlin and Java Android app","archived":false,"fork":false,"pushed_at":"2025-01-09T08:03:18.000Z","size":45459,"stargazers_count":16,"open_issues_count":18,"forks_count":28,"subscribers_count":19,"default_branch":"master","last_synced_at":"2025-05-03T07:38:37.190Z","etag":null,"topics":["content-delivery","delivery-sdk","hacktoberfest","headless-cms","java","kontent-ai","kontent-ai-sample","kontent-ai-tool","kotlin","kotlin-android"],"latest_commit_sha":null,"homepage":"https://kontent.ai/learn/tutorials/develop-apps/overview/?tech=java","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kontent-ai.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-08-15T18:39:22.000Z","updated_at":"2025-04-23T13:28:59.000Z","dependencies_parsed_at":"2025-01-10T08:32:36.256Z","dependency_job_id":null,"html_url":"https://github.com/kontent-ai/java-packages","commit_stats":null,"previous_names":["kentico/kontent-java-packages","kentico/delivery-sdk-java"],"tags_count":22,"template":false,"template_full_name":null,"purl":"pkg:github/kontent-ai/java-packages","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kontent-ai%2Fjava-packages","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kontent-ai%2Fjava-packages/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kontent-ai%2Fjava-packages/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kontent-ai%2Fjava-packages/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kontent-ai","download_url":"https://codeload.github.com/kontent-ai/java-packages/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kontent-ai%2Fjava-packages/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267476238,"owners_count":24093458,"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","status":"online","status_checked_at":"2025-07-28T02:00:09.689Z","response_time":68,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["content-delivery","delivery-sdk","hacktoberfest","headless-cms","java","kontent-ai","kontent-ai-sample","kontent-ai-tool","kotlin","kotlin-android"],"created_at":"2024-11-12T22:17:13.721Z","updated_at":"2026-01-11T17:35:58.746Z","avatar_url":"https://github.com/kontent-ai.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kontent.ai Java Packages\r\n\r\n[![Stack Overflow](https://img.shields.io/badge/Stack%20Overflow-ASK%20NOW-FE7A16.svg?logo=stackoverflow\u0026logoColor=white)](https://stackoverflow.com/tags/kontent-ai)\r\n[![Discord](https://img.shields.io/discord/821885171984891914?color=%237289DA\u0026label=Kontent.ai%20Discord\u0026logo=discord)](https://discord.gg/SKCxwPtevJ)\r\n\r\nMonorepo with Java Kontent.ai packages.\r\n\r\n## Packages\r\n\r\n|                                   Package                                   | Summary                                                                                                                                                                                                        |                                                                                       Version                                                                                        |\r\n| :-------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |\r\n|            [Kontent.ai Delivery Java SDK](/delivery-sdk#readme)             | The Kontent.ai Delivery Java SDK is a client library used for retrieving content from [Kontent.ai](https://kontent.ai)                                                                                         |           [![Maven Central](https://img.shields.io/maven-central/v/ai.kontent/delivery-sdk)](https://s01.oss.sonatype.org/content/groups/public/ai/kontent/delivery-sdk/)            |\r\n|          [Kontent.ai Generators](/delivery-sdk-generators#readme)           | This tool generates strongly-typed models based on Content Types in a Kontent.ai project.                                                                                                                      | [![Maven Central](https://img.shields.io/maven-central/v/ai.kontent/delivery-sdk-generators)](https://s01.oss.sonatype.org/content/groups/public/ai/kontent/delivery-sdk-generators) |\r\n|     [Kontent.ai Sample Spring Boot app](/sample-app-spring-boot#readme)     | Showcase of the [Spring boot](https://spring.io/projects/spring-boot) application displaying data from Kontent.ai.                                                                                             |                                                                     [source](/sample-app-spring-boot/README.md)                                                                      |\r\n|   [Kontent.ai Sample Gradle Console app](/test-gradle-console-app#readme)   | Simple Java console application showcasing how to load data from Kontent.ai.                                                                                                                                   |                                                                     [source](/test-gradle-console-app/README.md)                                                                     |\r\n|     [Kontent.ai Sample Android app (Java)](/sample-app-android#readme)      | Showcase of the [Android](https://www.android.com/) application written in Java using [RxJava](https://github.com/ReactiveX/RxJava) for data fetching from Kontent.ai.                                         |                                                                       [source](/sample-app-android/README.md)                                                                        |\r\n| [Kontent.ai Sample Android app (Kotlin)](/sample-app-android-kotlin#readme) | Showcase of the [Android](https://www.android.com/) application written in Kotlin using [Kotlin Coroutines](https://kotlinlang.org/docs/reference/coroutines-overview.html) for data fetching from Kontent.ai. |                                                                    [source](/sample-app-android-kotlin/README.md)                                                                    |\r\n| [Kontent.ai Java packages docs](/docs#readme) | Documentation for Kontent.ai Java packages |[source](/docs/README.md)|\r\n\r\n## Development\r\n\r\nIf you wish to find out more about the project specification. Check out the [Project information](/PROJECT.md).\r\n\r\n### Prerequisites\r\n\r\n**Required:**\r\n\r\n- Java 8 SDK (Oracle \u0026 OpenJDK both tested and supported)\r\n- [Android SDK](https://developer.android.com/studio#downloads) for the sample application (minimal version 28) - command line tools would be sufficient\r\n\r\n### Build and Test\r\n\r\n- Ensure your `JAVA_HOME` environment is set.\r\n- Clone this repository\r\n\r\n  ```sh\r\n  git clone https://github.com/kontent-ai/java-packages\r\n  ```\r\n\r\n- Enter the cloned repository\r\n\r\n  ```sh\r\n  cd kontent-java-packages\r\n  ```\r\n\r\n- Copy `local.properties.template` file in this directory to `local.properties` (which will be ignored by Git)\r\n\r\n- Set the `sdk.dir` variable Android SDK location\r\n\r\n- Build the project via the provided Gradle wrapper.\r\n\r\n  \u003e To grant execution rights for `gradlew` binary, you could use `chmod a+x ./gradlew` which allows execution to everybody.\r\n\r\n  ```sh\r\n  ./gradlew clean build\r\n  ```\r\n\r\n  \u003e The command will build whole solution and run all tests in this monorepo.\r\n\r\n### Dependency verification\r\n\r\nDue to security reasons the [verifications of dependencies checksums]('https://docs.gradle.org/6.3/userguide/dependency_verification.html') is enabled in this repository. When you update the dependency on some libray you might need to update `gradle/verification-metadata.xml`. \r\n\r\nTo let gradle obtain checksum and rewrite them to gradle/verification-metadata.xml` you can use command:\r\n\r\n``` bash\r\ngradle --write-verification-metadata sha256 help \r\n```\r\n\r\nHowever, we recommend to use the command with switch option `--dry-run` to create a copy of the file and check the results before:\r\n\r\n``` bash\r\ngradle --write-verification-metadata sha256 help --dry-run\r\n```\r\n\r\n#### :bulb: Next steps\r\n\r\nThe ideal next step is to test out the [Kontent.ai Sample Spring Boot app](/sample-app-spring-boot#readme) or load the\r\nproject in In IDE ([IntelliJ IDEA](https://www.jetbrains.com/idea/) recommended) and run/debug tests\r\nin [Kontent.ai Delivery Java SDK](/delivery-sdk#readme).\r\n\r\n## Publishing\r\n\r\n\u003e To publish a new version, it is required to have write permissions for this repository (to be able to create releases) and access to the [Nexus Repository Manager](https://s01.oss.sonatype.org/).\r\n\r\n1. Verify that everything in the branch is ready to be published and\r\n   the [build and tests](https://github.com/kontent-ai/java-packages/actions/workflows/gradle.yml) are passing.\r\n1. Create new GitHub release - **the tag name of the release will be used as a version**\r\n\r\n   - If you define tag name with \"-SNAPSHOT\" suffix i.e. `5.0.0-SNAPSHOT` artifact will be published to\r\n     the `https://s01.oss.sonatype.org/content/repositories/snapshots/`, so that you could use it when you want to try out\r\n     the beta version.\r\n\r\n   - The creation of a release triggers\r\n     the [Publish Github workflow](https://github.com/kontent-ai/java-packages/actions/workflows/publish.yml) and\r\n     creates and publishes the artifacts to \"Staging\" repositories on Nexus repository manager.\r\n\r\n1. Log in to the [Nexus Repository Manager](https://s01.oss.sonatype.org/).\r\n1. Select \"Staging repositories\", verify the repository content (_sometimes it takes a couple of minutes until the\r\n   repository is visible in the Nexus Repository Manager UI_).\r\n1. Close the Staging repository\r\n1. Release the Closed repository\r\n1. Increase the patch version and append `-SNAPSHOT` in the bottom of `/build.gradle` file (i.e. `4.4.1-SNAPSHOT`).\r\n\r\n\u003e 💡 This is just an abbreviated description of the publishing process. If you want to see the detailed publishing description, checkout the [wiki page \"Publishing process\"](./docs/Release-process.md).\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkontent-ai%2Fjava-packages","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkontent-ai%2Fjava-packages","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkontent-ai%2Fjava-packages/lists"}