{"id":18542188,"url":"https://github.com/heremaps/here-artifact-sbt-resolver","last_synced_at":"2025-04-09T18:31:40.461Z","repository":{"id":42470467,"uuid":"266089652","full_name":"heremaps/here-artifact-sbt-resolver","owner":"heremaps","description":"The HERE platform SBT Resolver plugin provides Java and Scala developers with access to platform artifacts via SBT","archived":false,"fork":false,"pushed_at":"2025-01-08T11:51:07.000Z","size":93,"stargazers_count":2,"open_issues_count":1,"forks_count":8,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-24T10:21:17.497Z","etag":null,"topics":["here-workspace","sbt","sbt-resolver","scala"],"latest_commit_sha":null,"homepage":"","language":"Scala","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/heremaps.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}},"created_at":"2020-05-22T11:04:35.000Z","updated_at":"2025-01-08T11:45:25.000Z","dependencies_parsed_at":"2024-01-15T14:44:02.865Z","dependency_job_id":null,"html_url":"https://github.com/heremaps/here-artifact-sbt-resolver","commit_stats":null,"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fhere-artifact-sbt-resolver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fhere-artifact-sbt-resolver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fhere-artifact-sbt-resolver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heremaps%2Fhere-artifact-sbt-resolver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/heremaps","download_url":"https://codeload.github.com/heremaps/here-artifact-sbt-resolver/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248087777,"owners_count":21045589,"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":["here-workspace","sbt","sbt-resolver","scala"],"created_at":"2024-11-06T20:07:40.967Z","updated_at":"2025-04-09T18:31:35.452Z","avatar_url":"https://github.com/heremaps.png","language":"Scala","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://github.com/heremaps/here-artifact-sbt-resolver/actions/workflows/release.yml/badge.svg)](https://github.com/heremaps/here-artifact-sbt-resolver/actions?query=workflow%3ARelease+branch%3Amaster)\n[![Maven Central](https://maven-badges.herokuapp.com/maven-central/com.here.platform.artifact/sbt-resolver/badge.svg)](https://search.maven.org/artifact/com.here.platform.artifact/sbt-resolver)\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)\n\n# HERE SBT Resolver for Workspace and Marketplace\n\n## Introduction\nThe HERE platform SBT resolver plugin provides Java and Scala developers with access to HERE platform\nartifacts via SBT. It uses your HERE platform credentials to generate tokens so that it can pull your\nSBT project dependencies from the HERE platform.\n\nThis allows Marketplace and Workspace users to [fetch platform schemas](https://www.here.com/docs/bundle/here-workspace-developer-guide-java-scala/page/proto-schema/README.html).\nIn addition, the users can [fetch the Java / Scala Data Client Library](https://www.here.com/docs/bundle/data-client-library-developer-guide-java-scala/page/client/get-data.html)\nwhich offer access to data in the HERE Data API.\n\nGo to [the HERE Developer portal](https://developer.here.com/products/platform) to learn more about the HERE platform.\n\n## Limitation\nThe SBT resolver plugin is provided 'as is' and not officially part of Workspace or Marketplace.\nWhile there is no official support by HERE, you may still raise issues via GitHub. We may be able to help.\n\n## Prerequisites\nTo access the libraries and schemas from the HERE platform, you need a HERE Workspace and/or a HERE Marketplace account.\nIf you don’t have an account yet, go to [Pricing and Plans](https://www.here.com/get-started/pricing) to apply for a free trial.\n\nOnce you have enabled your account you need to create the credentials and prepare your environment.\nWorkspace users can find corresponding guidance [in the documentation for Java and Scala developers](https://www.here.com/docs/bundle/here-workspace-developer-guide-java-scala/page/topics/how-to-use-sdk.html).\nMarketplace users can find instructions in the [Marketplace Consumer user guide](https://www.here.com/docs/bundle/marketplace-consumer-user-guide/page/topics/link-catalogs.html#set-up-your-credentials).\n\nPlease note, by default the SBT Resolver plugin uses the `credentials.properties` file provided in the `.here` directory in the user home directory. \nThere are two options to override the path:\n- The first option is the system property `hereCredentialsFile`, the property should be added to the sbt command the following way `-DhereCredentialsFile=/full/path/to/credentials.properties`.\n- The second option is the environment variable `HERE_CREDENTIALS_FILE`.  The variable should contain the full file path to the `credentials.properties` file to be used. The variable is taken into account only if there is no system property provided.\n\nThis version is compatible with:\n - Scala 2.11/2.12\n - SBT 1.x\n\n## How to use it?\nThis SBT resolver plugin is published on [Maven Central](https://search.maven.org/artifact/com.here.platform.artifact/sbt-resolver)\nso you can conveniently use it from your project.\nThe `sbt-resolver` plugin can be registered by adding an entry to `projects/plugins.sbt` file as follows:\n\n\n    addSbtPlugin(\"com.here.platform.artifact\" % \"sbt-resolver\" % sbtResolverVersion)\n\n\nFor example, to fetch the HERE Map Content - Topology Geometry - Protocol Buffers schema and the related Java and Scala bindings set the following dependencies:\n\n\n    resolvers += \"HERE_PLATFORM_ARTIFACT\" at \"here+artifact-service://artifact-service\"\n\n    libraryDependencies += \"com.here.schema.rib\" % \"topology-geometry_v2_proto\" % topologyGeometryVersion\n    libraryDependencies += \"com.here.schema.rib\" % \"topology-geometry_v2_java\" % topologyGeometryVersion\n    libraryDependencies += \"com.here.schema.rib\" % \"topology-geometry_v2_scala\" % topologyGeometryVersion\n\n\nAs a Marketplace user you can add this dependency for fetching the Java / Scala Data Client Library:\n\n\n    resolvers += \"HERE_PLATFORM_ARTIFACT\" at \"here+artifact-service://artifact-service\"\n\n    libraryDependencies += \"com.here.platform.data.client\" %% \"data-client\" % dataClientVersion\n\n\n`here+artifact-service://artifact-service` is placeholder URL which will be replaced by plugin dynamically based on your credentials.\nThe latest versions of the Data Client Library and Schemas can be found in [SDK documentation](https://www.here.com/docs/bundle/here-workspace-developer-guide-java-scala/page/sdk-libraries.html).\n\n#### Proxy Setup\nTo enable SBT and the HERE SBT resolver plugin to work behind a proxy,\nyou need to use standard `http_proxy` and `https_proxy` environment variables, like:\n```shell\nsbt -Dhttp.proxyHost=PROXY_HOST -Dhttp.proxyPort=PROXY_PORT -Dhttp.proxyUser=PROXY_USERNAME -Dhttp.proxyPassword=PROXY_PASSWORD\n```\nAlternatively, pass those by setting `JAVA_OPTS` in the environment variable, like:\n```shell\nexport JAVA_OPTS=\"-Dhttp.proxyHost=PROXY_HOST -Dhttp.proxyPort=PROXY_PORT -Dhttp.proxyUser=PROXY_USERNAME -Dhttp.proxyPassword=PROXY_PASSWORD\"\n```\n\n## License\nCopyright (C) 2019-2024 HERE Europe B.V.\n\nUnless otherwise noted in `LICENSE` files for specific files or directories, the [LICENSE](LICENSE) in the root applies to all content in this repository.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheremaps%2Fhere-artifact-sbt-resolver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fheremaps%2Fhere-artifact-sbt-resolver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheremaps%2Fhere-artifact-sbt-resolver/lists"}