6.6.5 Path, File and Folder Name Restrictions
You should only use the following ASCII characters for path, file and folder names:
- A through Z
- a through z
- 0 through 9
- underscore: _
- dash: -
- period: .
Makefile
If you have files or directories within the project directory using either the
()
or []
characters ( e.g., t (1).c
), or if you use absolute paths to directories with these characters, the characters will
cause the "no rule to make target" problem.
The workaround is to avoid doing it at this time. System libraries can be added through the project properties and therefore, do not need to be added to the project.
Cross-Platform Operating Systems
If you plan on using MPLAB X IDE on different platforms (Windows OS, Linux OS or macOS), be aware of these issues:
- Use the forward slash “/” in relative paths. The backslash “\” works
only on Windows OS platforms. Example:
#include headers/myheader.h
. - Linux OS is case-sensitive, so
generictypedefs.h
is not the same asGenericTypeDefs.h
.
Windows Operation System
Windows operating systems have a maximum path length of 260 characters. An explanation from Microsoft is found here:
msdn.microsoft.com/en-us/library/windows/desktop/aa365247(v=vs.85).aspx
Although Windows will attempt to stop you from creating path lengths that are too long, it is possible to do this (from certain applications, cutting-and-pasting, etc.) If a project source file uses such a path, the project will not build correctly. Additionally, there is a command-line limitation for Windows OS of 8191 characters.
For workarounds, see 12.5 Errors.