From a630f401e5314da1ccf1eb0d90b9acd9428fae20 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Thomas=20Delhom=C3=A9nie?= Date: Fri, 29 Aug 2025 14:18:43 +0200 Subject: [PATCH 1/2] Add troubleshooting section for unresolved dependency when no repository declared --- SDK6UserGuide/install.rst | 4 +-- SDK6UserGuide/troubleshooting.rst | 49 +++++++++++++++++++++++++++---- 2 files changed, 46 insertions(+), 7 deletions(-) diff --git a/SDK6UserGuide/install.rst b/SDK6UserGuide/install.rst index 1f51ae384..c17f0c2a7 100644 --- a/SDK6UserGuide/install.rst +++ b/SDK6UserGuide/install.rst @@ -63,7 +63,7 @@ the :ref:`Central ` and :ref:`Developer /.gradle/init.d`` if it does not exist. - Download and copy :download:`this file ` in the previously created folder. At this stage, you can already build a project from the command line, @@ -81,7 +81,7 @@ SDK EULA Acceptation The use of MICROEJ SDK 6 requires to accept the :ref:`sdk6_eula`. The acceptance can be done at the project level or system-wide. For a system-wide acceptance, we recommend to define -the ``accept-microej-sdk-eula-v3-1c`` system property in a ``gradle.properties`` file in your Gradle User Home folder ``$USER_HOME/.gradle/gradle.properties``: +the ``accept-microej-sdk-eula-v3-1c`` system property in a ``gradle.properties`` file in your Gradle User Home folder ``/.gradle/gradle.properties``: .. code:: properties diff --git a/SDK6UserGuide/troubleshooting.rst b/SDK6UserGuide/troubleshooting.rst index b5f6d8449..8b8ed7290 100644 --- a/SDK6UserGuide/troubleshooting.rst +++ b/SDK6UserGuide/troubleshooting.rst @@ -64,15 +64,54 @@ The solution is to use a JDK 11 or a higher LTS version (``11``, ``17`` or ``21` Project JDK in IntelliJ IDEA and Android Studio -Unresolved Dependency ---------------------- +Unresolved Dependency When No Repository +---------------------------------------- If this kind of message appears when resolving plugins or modules dependencies: .. code:: console - * What went wrong: - Plugin [id: 'com.microej.gradle.application', version: '1.3.1'] was not found in any of the following sources: + * What went wrong: + Plugin [id: 'com.microej.gradle.application', version: '1.3.1'] was not found in any of the following sources: + + - Gradle Core Plugins (plugin is not in 'org.gradle' namespace) + - Included Builds (No included builds contain this plugin) + - Plugin Repositories (could not resolve plugin artifact 'com.microej.gradle.application:com.microej.gradle.application.gradle.plugin:1.1.0') + Searched in the following repositories: + Gradle Central Plugin Repository + +or this kind: + +.. code:: console + + * What went wrong: + Execution failed for task ':compileJava'. + > Could not resolve all files for configuration ':compileClasspath'. + > Cannot resolve external dependency ej.api:edc:1.3.7 because no repositories are defined. + Required by: + root project : + +It means that no module or plugin repository has been defined. +Make sure that the repositories have been configured as described in the :ref:`sdk_6_configure_repositories` section. +In particular, make sure that the Gradle Init script is in the ``./gradle/init.d`` folder in the user home folder. + +Unresolved Dependency in Repositories +------------------------------------- + +If this kind of message appears when resolving plugins or modules dependencies: + +.. code:: console + + * What went wrong: + Plugin [id: 'com.microej.gradle.application', version: '1.3.1'] was not found in any of the following sources: + + - Gradle Core Plugins (plugin is not in 'org.gradle' namespace) + - Included Builds (No included builds contain this plugin) + - Plugin Repositories (could not resolve plugin artifact 'com.microej.gradle.application:com.microej.gradle.application.gradle.plugin:1.3.1') + Searched in the following repositories: + microEJCentral(https://repository.microej.com/modules) + microEJForgeCentral(https://forge.microej.com/artifactory/microej-central-repository-release) + microEJForgeDeveloper(https://forge.microej.com/artifactory/microej-developer-repository-release) or this kind: @@ -91,7 +130,7 @@ or this kind: project : -First, check that either the requested plugin or module exists in your repository. +First, check that either the requested plugin or module exists in the listed repositories. - If the plugin or module does not exist, From 92e3ce391122d0708c1ef105c00c30689c02cb34 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Thomas=20Delhom=C3=A9nie?= Date: Mon, 1 Sep 2025 12:03:33 +0200 Subject: [PATCH 2/2] Detail Gradle User Home folder troubleshooting --- SDK6UserGuide/troubleshooting.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/SDK6UserGuide/troubleshooting.rst b/SDK6UserGuide/troubleshooting.rst index 8b8ed7290..2582b13e9 100644 --- a/SDK6UserGuide/troubleshooting.rst +++ b/SDK6UserGuide/troubleshooting.rst @@ -93,7 +93,10 @@ or this kind: It means that no module or plugin repository has been defined. Make sure that the repositories have been configured as described in the :ref:`sdk_6_configure_repositories` section. -In particular, make sure that the Gradle Init script is in the ``./gradle/init.d`` folder in the user home folder. +In particular, make sure that the Gradle Init script is in the ``.gradle/init.d`` folder in the Gradle User Home folder. +The Gradle User Home folder is defined by default to the OS User Home folder, +and can be changed by setting the ``GRADLE_USER_HOME`` environment variable +or in the IDE settings (see `Intellij IDEA documentation `__). Unresolved Dependency in Repositories -------------------------------------