Troubleshoot Dependency Errors

Dependency resolution errors occur when the software cannot resolve the required packages for your project. When a dependency error occurs, an “Unable to Resolve Dependencies” message appears on the Configuration tab of your project page.

Below are some common remediation steps you can take to successfully resolve dependency errors in your project, followed by some specific errors and ways to address them.

Remediation

Regardless of the error type, you can use several options to resolve dependency issues:

  • Changing the requirement name/version
  • Changing the operating system of your project
  • Removing and re-adding a package
  • Removing required package(s)
  • Requesting a package import and waiting to update
    • Known use cases are a large factor in our package import process, providing detailed feedback along with a package request helps with prioritization. To request a package import contact us.
  • Wait and update without requesting a package import
    • The catalog is regularly revised and patched for emergent issues. Many issues are resolved in the background by our team, so the “wait and try again” approach is often successful. For recent language and package additions check here.

Error: Dependency does not resolve because root depends on <package> which doesn’t match any versions

This error indicates that the required package cannot be found in the Platform catalog. Check the following potential causes:

  • Spelling error in package name
  • Error in version number or syntax of number
  • The package is not available in our catalog yet (this is common with private or proprietary packages where a trusted source is not available)
  • The package version is not available in our catalog yet

To resolve these errors, review the package list and our import syntax. Use the “Add Packages” dialog on the Configuration page to verify which packages and versions are currently available.

If the package is still not visible, request the package and include your use case to help prioritize catalog updates.

Error: Dependency does not resolve because no versions of < package with requirements > and root depends on < required package >

This error occurs when a solution for the specified package cannot be created. Check the following potential causes and solutions:

  • An additional package that the requested package required for the build does not exist in our catalog yet.
    • Common requests of this type are compiled and reported to our team for prioritization. Letting us know your use case can help us understand what updates will make the most impact. To request a package contact us.
  • The software cannot create a solution given the user-selected package versions.
    • This can usually be resolved by selecting “Auto” from the version list instead of a specific version.
  • Packages have conflicting requirements on a package version.
    • Reconfigure the package requirements to remove the interdependency.
    • These errors may also be resolved through revisions to the packages which relax the dependencies. These revisions are applied as scheduled updates to our package catalog occur.
  • “Platform does not support the selected package requirements” and “Package is not available on the selected platform”.
    • The above are remediated by changing the Platform or package requirements to supported configurations.

Other Errors

  • Timeout: If a large set of requirements has too many package versions to resolve and the servers have a greater than usual load the solution processes may time out.
    • This can be resolved with a refresh.
  • The solution is depreciated: if an old build is revised, some of the existing solutions may no longer be valid given updates to the available packages and dependencies.
    • This error is rare as the software should resolve this issue automatically by refreshing the build.