Change Windows install tree to match Linux install tree.
* Move all Windows install subfolders from ${CMAKE_INSTALL_PREFIX}/share/ to ${CMAKE_INSTALL_PREFIX}/share/kicad/. * Remove unused define DEFAULT_FP_LIB_PATH from build configuration. * Remove Boost target when skipping internal Boost build. * Update INSTALL.txt to reflect install tree changes.
This commit is contained in:
parent
7b5318ff64
commit
03d50b2213
|
@ -303,40 +303,22 @@ set( KIFACE_PREFIX "_" )
|
||||||
|
|
||||||
#================================================
|
#================================================
|
||||||
# Locations for install targets.
|
# Locations for install targets.
|
||||||
|
#================================================
|
||||||
|
if( NOT APPLE )
|
||||||
|
# Everything without leading / is relative to CMAKE_INSTALL_PREFIX.
|
||||||
set( KICAD_BIN bin
|
set( KICAD_BIN bin
|
||||||
CACHE PATH "Location of KiCad binaries." )
|
CACHE PATH "Location of KiCad binaries." )
|
||||||
|
|
||||||
set( KICAD_FP_LIB_INSTALL_PATH "${CMAKE_INSTALL_PREFIX}"
|
|
||||||
CACHE PATH "Default path where footprint libraries are installed." )
|
|
||||||
|
|
||||||
if( UNIX AND NOT APPLE )
|
|
||||||
# Everything without leading / is relative to CMAKE_INSTALL_PREFIX.
|
|
||||||
set( KICAD_PLUGINS lib/kicad/plugins
|
set( KICAD_PLUGINS lib/kicad/plugins
|
||||||
CACHE PATH "Location of KiCad plugins." )
|
CACHE PATH "Location of KiCad plugins." )
|
||||||
set( KICAD_DATA share/kicad
|
set( KICAD_DATA share/kicad
|
||||||
CACHE PATH "Location of KiCad data files." )
|
CACHE PATH "Location of KiCad data files." )
|
||||||
set( KICAD_DOCS share/doc/kicad
|
set( KICAD_DOCS share/doc/kicad
|
||||||
CACHE PATH "Location of KiCad documentation files." )
|
CACHE PATH "Location of KiCad documentation files." )
|
||||||
set( KICAD_FP_LIB_INSTALL_PATH "${KICAD_FP_LIB_INSTALL_PATH}/share/kicad/modules" )
|
|
||||||
endif()
|
|
||||||
|
|
||||||
if( MINGW )
|
|
||||||
# Everything without leading / is relative to CMAKE_INSTALL_PREFIX.
|
|
||||||
set( KICAD_PLUGINS ${KICAD_BIN}/plugins
|
|
||||||
CACHE PATH "Location of KiCad plugins." )
|
|
||||||
set( KICAD_DATA share
|
|
||||||
CACHE PATH "Location of KiCad data files." )
|
|
||||||
set( KICAD_DOCS doc
|
|
||||||
CACHE PATH "Location of KiCad documentation files." )
|
|
||||||
set( KICAD_FP_LIB_INSTALL_PATH "${KICAD_FP_LIB_INSTALL_PATH}/modules" )
|
|
||||||
endif()
|
|
||||||
|
|
||||||
set( KICAD_DEMOS ${KICAD_DATA}/demos
|
set( KICAD_DEMOS ${KICAD_DATA}/demos
|
||||||
CACHE PATH "Location of KiCad demo files." )
|
CACHE PATH "Location of KiCad demo files." )
|
||||||
set( KICAD_TEMPLATE ${KICAD_DATA}/template
|
set( KICAD_TEMPLATE ${KICAD_DATA}/template
|
||||||
CACHE PATH "Location of KiCad template files." )
|
CACHE PATH "Location of KiCad template files." )
|
||||||
|
else()
|
||||||
if( APPLE )
|
|
||||||
# everything without leading / is relative to CMAKE_INSTALL_PREFIX.
|
# everything without leading / is relative to CMAKE_INSTALL_PREFIX.
|
||||||
# CMAKE_INSTALL_PREFIX is root of .dmg image
|
# CMAKE_INSTALL_PREFIX is root of .dmg image
|
||||||
set( KICAD_BIN ${CMAKE_INSTALL_PREFIX}
|
set( KICAD_BIN ${CMAKE_INSTALL_PREFIX}
|
||||||
|
@ -372,10 +354,6 @@ if( APPLE )
|
||||||
set( KICAD_DEMOS demos
|
set( KICAD_DEMOS demos
|
||||||
CACHE PATH "Location of KiCad demo files." FORCE )
|
CACHE PATH "Location of KiCad demo files." FORCE )
|
||||||
|
|
||||||
# used to set DEFAULT_FP_LIB_PATH in config.h.cmake, but then never used
|
|
||||||
# set it to correct value just in case (see common.cpp)
|
|
||||||
set( KICAD_FP_LIB_INSTALL_PATH "~/Library/Preferences/kicad" )
|
|
||||||
|
|
||||||
# Override default paths for fixup_bundle
|
# Override default paths for fixup_bundle
|
||||||
set( OSX_BUNDLE_OVERRIDE_PATHS "
|
set( OSX_BUNDLE_OVERRIDE_PATHS "
|
||||||
function( gp_item_default_embedded_path_override item default_embedded_path_var )
|
function( gp_item_default_embedded_path_override item default_embedded_path_var )
|
||||||
|
@ -553,8 +531,6 @@ if( KICAD_SKIP_BOOST )
|
||||||
message( FATAL_ERROR "Boost 1.54+ libraries are required." )
|
message( FATAL_ERROR "Boost 1.54+ libraries are required." )
|
||||||
endif()
|
endif()
|
||||||
|
|
||||||
add_custom_target( boost ) # it is required to meet some further dependencies
|
|
||||||
|
|
||||||
message( WARNING "
|
message( WARNING "
|
||||||
WARNING: You decided to skip building boost library.
|
WARNING: You decided to skip building boost library.
|
||||||
KiCad developers strongly advise you to build the bundled boost library, as it is known to work with KiCad.
|
KiCad developers strongly advise you to build the bundled boost library, as it is known to work with KiCad.
|
||||||
|
|
|
@ -61,9 +61,6 @@
|
||||||
/// The install prefix defined in CMAKE_INSTALL_PREFIX.
|
/// The install prefix defined in CMAKE_INSTALL_PREFIX.
|
||||||
#define DEFAULT_INSTALL_PATH "@CMAKE_INSTALL_PREFIX@"
|
#define DEFAULT_INSTALL_PATH "@CMAKE_INSTALL_PREFIX@"
|
||||||
|
|
||||||
/// Default footprint library install path when installed with `make install`.
|
|
||||||
#define DEFAULT_FP_LIB_PATH "@KICAD_FP_LIB_INSTALL_PATH@"
|
|
||||||
|
|
||||||
/// When defined, build the GITHUB_PLUGIN for pcbnew.
|
/// When defined, build the GITHUB_PLUGIN for pcbnew.
|
||||||
#cmakedefine BUILD_GITHUB_PLUGIN
|
#cmakedefine BUILD_GITHUB_PLUGIN
|
||||||
|
|
||||||
|
|
104
INSTALL.txt
104
INSTALL.txt
|
@ -24,31 +24,16 @@ Installation from binary packages
|
||||||
Installation from binary packages for Windows
|
Installation from binary packages for Windows
|
||||||
---------------------------------------------
|
---------------------------------------------
|
||||||
|
|
||||||
KiCad can be installed in 'C:\kicad', 'D:\kicad', 'C:\Program files\kicad',
|
The KiCad binary archive can be installed anywhere on the system that as long as the user
|
||||||
'D:\Program files\kicad'.
|
has write privileges.
|
||||||
|
|
||||||
For example, for an installation in the folder 'C:\kicad', unzip KiCad
|
You can create a shortcut to '${prefix}\bin\kicad.exe' where ${prefix} is the install path.
|
||||||
packages:
|
|
||||||
|
|
||||||
kicad-{version}.zip
|
|
||||||
kicad-doc-{version}.zip
|
|
||||||
kicad-library-{version}.zip
|
|
||||||
|
|
||||||
to the folder 'C:\kicad'.
|
|
||||||
|
|
||||||
The main program is the project manager (kicad.exe) and from it you can run
|
|
||||||
the other programs (schematic editor - eeschema, pcb editor - pcbnew,
|
|
||||||
utilities: cvpcb and gerbview).
|
|
||||||
|
|
||||||
You can create a shortcut to 'C:\kicad\bin\kicad.exe'.
|
|
||||||
|
|
||||||
|
|
||||||
Installation from binary packages for Linux
|
Installation from binary packages for Linux
|
||||||
-------------------------------------------
|
-------------------------------------------
|
||||||
|
|
||||||
KiCad can be installed in '/usr' or '/usr/local'.
|
KiCad can be installed in '/usr' or '/usr/local'. You must have "root" access for installation.
|
||||||
|
|
||||||
You must have "root" access for installation.
|
|
||||||
|
|
||||||
cd /
|
cd /
|
||||||
tar -xjf kicad-{version}.tbz2
|
tar -xjf kicad-{version}.tbz2
|
||||||
|
@ -58,53 +43,24 @@ Installation from binary packages for Linux
|
||||||
The main program is '/usr/bin/kicad'.
|
The main program is '/usr/bin/kicad'.
|
||||||
|
|
||||||
|
|
||||||
Windows KiCad tree
|
Linux and Windows KiCad install tree
|
||||||
------------------
|
-------------------------------------
|
||||||
|
|
||||||
kicad/bin - Binaries (executable files).
|
${prefix}/bin - Binaries (executable files).
|
||||||
kicad/doc - Various documentation.
|
${prefix}/share/doc/kicad/ - Various documentation.
|
||||||
kicad/doc/help - Interactive help.
|
${prefix}/share/doc/kicad/help - Interactive help.
|
||||||
kicad/share/demos - Sample schematics and printed boards.
|
${prefix}/share/kicad/demos - Sample schematics and printed boards.
|
||||||
kicad/share/internat - Interface localization files.
|
${prefix}/share/kicad/internat - Dictionaries for interface localization.
|
||||||
kicad/share/library - Libraries for schematic.
|
${prefix}/share/kicad/library - Interface localization files.
|
||||||
kicad/share/modules - Module libraries for printed boards.
|
${prefix}/share/kicad/modules - Module libraries for printed boards.
|
||||||
kicad/share/modules/packages3d - 3D component models (.wrl and .wings format).
|
${prefix}/share/kicad/modules/packages3d - 3D component models (.wrl and .wings format).
|
||||||
|
|
||||||
Files '*.mod' are libraries, and files '*.brd' are printed boards you can
|
KiCad searches for the libraries, templates, 3D models, etc. bin/../share.
|
||||||
view with pcbnew.
|
|
||||||
Files *.brd show the existing modules (and 3D shapes) in libraries.
|
|
||||||
|
|
||||||
|
|
||||||
Linux KiCad tree
|
|
||||||
----------------
|
|
||||||
KiCad can use the Windows tree or the below tree.
|
|
||||||
When Kicad is coming from Linux distribution, the tree is:
|
|
||||||
|
|
||||||
/usr/bin - Binaries (executable files).
|
|
||||||
/usr/share/doc/kicad/ - Various documentation.
|
|
||||||
/usr/share/doc/kicad/help - Interactive help.
|
|
||||||
/usr/share/kicad/demos - Sample schematics and printed boards.
|
|
||||||
/usr/share/kicad/internat - Dictionaries for interface localization.
|
|
||||||
/usr/share/kicad/library - Interface localization files.
|
|
||||||
/usr/share/kicad/modules - Module libraries for printed boards.
|
|
||||||
/usr/share/kicad/modules/packages3d - 3D component models (.wrl and .wings format).
|
|
||||||
|
|
||||||
if KiCad does not found its files in usr/share, the search is made in
|
|
||||||
/usr/local/kicad
|
|
||||||
and kicad uses the same tree as the Windows KiCad tree above
|
|
||||||
|
|
||||||
*** When KiCad comes from .tgz archive from http://iut-tice.ujf-grenoble.fr/cao/,
|
|
||||||
it must me installed in /usr/local and uses the Windows tree ***.
|
|
||||||
|
|
||||||
|
|
||||||
Files '*.mod' are the libraries, and files '*.brd' are printed boards you can
|
|
||||||
view with pcbnew.
|
|
||||||
Files *.brd show the existing modules (and 3D shapes) in libraries.
|
|
||||||
|
|
||||||
Warning:
|
Warning:
|
||||||
Do not change the KiCad tree, or the location of binary files,
|
Do not change the KiCad tree, or the location of binary files. Otherwise
|
||||||
else KiCad will not be able to find its required files (configuration,
|
KiCad may not be able to find some or all of its required files.
|
||||||
libraries, etc.).
|
|
||||||
|
|
||||||
Mac OS X KiCad tree
|
Mac OS X KiCad tree
|
||||||
-------------------
|
-------------------
|
||||||
|
@ -122,26 +78,26 @@ User files can be the same as the system wide files but only inside the users ho
|
||||||
$HOME/Library/Application Support/kicad
|
$HOME/Library/Application Support/kicad
|
||||||
|
|
||||||
Warning:
|
Warning:
|
||||||
These paths are hardcoded into KiCad, if you put them somewhere else KiCad will not find them when a new
|
These paths are hardcoded into KiCad, if you put them somewhere else KiCad will not find
|
||||||
project is created.
|
them when a new project is created.
|
||||||
|
|
||||||
Installation from source code
|
Installation from source code
|
||||||
-----------------------------
|
-----------------------------
|
||||||
|
|
||||||
Some dependencies must be satisfied for the correct installation of KiCad:
|
Some dependencies must be satisfied for the correct installation of KiCad:
|
||||||
under Linux:
|
|
||||||
wxWidgets >= 2.8.11 http://www.wxwidgets.org/
|
|
||||||
(needs to be compiled with unicode support)
|
|
||||||
under Windows:MacOSX
|
|
||||||
wxWidgets >= 2.9.4 http://www.wxwidgets.org/
|
|
||||||
|
|
||||||
CMake >= 2.8.1 http://www.cmake.org/
|
wxWidgets >= 3.0.0 http://www.wxwidgets.org/
|
||||||
|
|
||||||
|
CMake >= 2.8.4 http://www.cmake.org/
|
||||||
|
|
||||||
Boost C++ Libraries:
|
Boost C++ Libraries:
|
||||||
files used by kicad are autmatically downloaded and patched if needed
|
files used by kicad are autmatically downloaded and patched if needed
|
||||||
from boost site ( http://www.boost.org/ )
|
from boost site ( http://www.boost.org/ )
|
||||||
|
|
||||||
OpenGL
|
OpenGL
|
||||||
Linux: Mesa 3D Graphics Library http://www.mesa3d.org/
|
Linux: Mesa 3D Graphics Library http://www.mesa3d.org/
|
||||||
Windows: built-in
|
Windows: built-in
|
||||||
|
|
||||||
Zlib Compression Library http://www.zlib.net/
|
Zlib Compression Library http://www.zlib.net/
|
||||||
|
|
||||||
In source-tree-build are mostly unwanted, so make a subdir called "build" and
|
In source-tree-build are mostly unwanted, so make a subdir called "build" and
|
||||||
|
@ -185,14 +141,6 @@ Required for Windows platform.
|
||||||
-DwxWidgets_USE_DEBUG=ON
|
-DwxWidgets_USE_DEBUG=ON
|
||||||
Can be used only with -DCMAKE_BUILD_TYPE=Debug
|
Can be used only with -DCMAKE_BUILD_TYPE=Debug
|
||||||
|
|
||||||
-DwxWidgets_USE_STATIC=ON
|
|
||||||
For building statically linked executables. Can be used only if wxWidgets
|
|
||||||
configured and builded with "--enable-monolithic --disable-shared" parameters.
|
|
||||||
|
|
||||||
-DwxWidgets_USE_STATIC=OFF
|
|
||||||
For building dinamically linked executables. Can be used only if wxWidgets
|
|
||||||
configured and builded with "--disable-monolithic --enable-shared" parameters.
|
|
||||||
|
|
||||||
-DKICAD_KEEPCASE=ON
|
-DKICAD_KEEPCASE=ON
|
||||||
Build the KiCad with no component name conversion to uppercase (if you want your
|
Build the KiCad with no component name conversion to uppercase (if you want your
|
||||||
ADuC.../Si.../bq... components named as just so).
|
ADuC.../Si.../bq... components named as just so).
|
||||||
|
|
Loading…
Reference in New Issue