Importing CCS Projects
Importing a project into CCS may sometimes fail with the error:
“Error: Import failed for project 'abc' because its compiler definition is not available”. Please install the X.Y.Z compiler before importing this project…”
This article explains when and why this error appears, and how it can be fixed.
Compiler releases included with CCS follow a certain version numbering scheme. It is recommended to read through this wiki page first to understand the compiler version numbers that are referenced in this article. This article uses X.Y.Z numbering to refer to both older and newer (STS/LTS) compiler version numbers.
For the purpose of this article we use the following acronyms:
- Project Compiler version (PCV) – refers to compiler version used to create the project that is being imported
- Known Compiler Version (KCV) – refers to compiler version(s) that are “known” to the user’s CCS installation
KCV: Every installation of CCS has a list of compiler versions “known” to it. The list comprises versions included with that CCS as well as versions that have historically shipped with CCS. Usually the latest version in the "known" list is the version shipped with that CCS. Note that the list of KCVs is specific to a installation of CCS. For these KCVs, CCS has the built-in model that is required to parse a project. As long as PCV is in the list of KCVs, CCS is able to successfully import the project.
A “new” compiler version is one that differs from KCV in either X or Y digit. For example, if 15.12.0.LTS compiler is the latest version in KCV, then 16.3.x.STS or 16.6.x.STS compiler is considered a “new” version. If PCV is a “new” version, CCS does not have the built-in model required to parse the project, hence is not be able to import the project.
In summary, for a project created with compiler version X.Y.Z (where X.Y.Z is not a KCV)
- if the version differs from KCV in only Z digit, then the project still imports
- if the version differs from KCV in either X or Y digit, then the project does not import and the above error message is generated
For example, if the latest version CCS ships with is 15.12.0, it can import projects created with 15.12.1, 15.12.9, etc. but not projects created with 16.12.0 or 17.3.0 (until that exact compiler version is installed and discovered by CCS).
To allow the project to import, install the exact compiler version with which the project was created. The required version is mentioned in the error message.