Files
gitea-pages/software/CSDataQuick/docs/installation.html
T
2025-07-08 08:18:09 +02:00

148 lines
8.1 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- installation.qdoc -->
<title>Installation | CSDataQuick Documentation 1.2</title>
<link rel="stylesheet" type="text/css" href="style/online.css" />
<script type="text/javascript">
(function (i, s, o, g, r, a, m) {
i['GoogleAnalyticsObject'] = r; i[r] = i[r] || function () {
(i[r].q = i[r].q || []).push(arguments)
}, i[r].l = 1 * new Date(); a = s.createElement(o),
m = s.getElementsByTagName(o)[0]; a.async = 1; a.src = g; m.parentNode.insertBefore(a, m)
})(window, document, 'script', '//www.google-analytics.com/analytics.js', 'ga');
ga('create', 'UA-24645639-4', 'qt.io');
ga('set', 'forceSSL', true);
ga('send', 'pageview');
</script>
</head>
<body>
<div class="header" id="header">
<header id="navbar" class="">
</header>
</div>
<div class="main">
<div class="main-rounded">
<div class="navigationbar">
<ul class="sub-navigation">
<li><a href="../../CSDataQuick.html">Home</a></li>
<li><a href="../docs.html" class="active">Documentation</a></li>
<li><a href="http://github.com/xiaoqiangwang/CSDataQuick/">Code</a></li>
<li><a href="https://github.com/xiaoqiangwang/CSDataQuick/issues/">Bug Reports</a></li>
</ul>
<div id="main_title_bar">
<h1>CSDataQuick Documentation</h1>
<div class="search_bar">
<script>
(function() {
var cx = '001693341472456439948:u9v0snkru3q';
var gcse = document.createElement('script');
gcse.type = 'text/javascript';
gcse.async = true;
gcse.src = (document.location.protocol == 'https:' ? 'https:' : 'http:') + '//www.google.com/cse/cse.js?cx=' + cx;
var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(gcse, s);
})();
</script>
<gcse:searchbox-only resultsUrl="search-results.html"></gcse:searchbox-only>
</div></div>
<ul>
<li><a href="index.html">CSDataQuick Documentation</a></li>
<li>Installation</li>
</ul>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="sidebar">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="installation.html#binary-pacakges">Binary pacakges</a></li>
<li class="level2"><a href="installation.html#packages-bundled-with-qt-creator">Packages bundled with Qt Creator</a></li>
<li class="level2"><a href="installation.html#anaconda-packages">Anaconda Packages</a></li>
<li class="level1"><a href="installation.html#dependencies">Dependencies</a></li>
<li class="level1"><a href="installation.html#macos-or-linux">macOS or Linux</a></li>
<li class="level1"><a href="installation.html#windows">Windows</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<div class="context">
<h1 class="title">Installation</h1>
<span class="subtitle"></span>
<!-- $$$installation.html-description -->
<div class="descr"> <a name="details"></a>
<a name="binary-pacakges"></a>
<h2 id="binary-pacakges">Binary pacakges</h2>
<a name="packages-bundled-with-qt-creator"></a>
<h3 >Packages bundled with Qt Creator</h3>
<p>To facilitate the usage, packages bundled with Qt Creator are available at http://epics.web.psi.ch/software/CSDataQuick/downloads. The packages are self-contained, including Qt libraries, EPICS base libraries, and a stripped down version of Qt Creator.</p>
<a name="anaconda-packages"></a>
<h3 >Anaconda Packages</h3>
<p>Anaconda is a Python distribution. It provides a reproducible way to deploy binary packages, not limited to Python. This module provides packages for linux-64, win-64 and osx-64 platform.</p>
<pre class="cpp">$ conda install <span class="operator">-</span>c paulscherrerinstitute csdataquick</pre>
<p>On Windows, if the module is not to be used by Python applications, the EPICS dll libraries have to be in path</p>
<pre class="cpp"><span class="operator">&gt;</span> set PATH<span class="operator">=</span><span class="operator">%</span>PATH<span class="operator">%</span>;C:\Miniconda3\epics\windows<span class="operator">-</span>x64</pre>
<a name="dependencies"></a>
<h2 id="dependencies">Dependencies</h2>
<ul>
<li>Qt 5.6 or higher</li>
<li>EPICS base 3.14.12 or higher</li>
<li>Git</li>
<li>cmake 2.8&#x2e;10 or higher</li>
</ul>
<p>On RHEL/Centos/SL 6.x, install qt5 from EPEL repository,</p>
<pre class="cpp"><span class="preprocessor"># yum install yum-conf-epel</span>
<span class="preprocessor"># yum --enablerepo=epel install qt5-qtdeclarative-devel</span>
<span class="preprocessor"># yum --enablerepo=epel install qt5-qtquickcontrols</span></pre>
<p>In the following instructions, EPICS base is assumed to be in <code>C:\epics\base-3.14.12</code> on Windows and <code>/usr/local/epics/base</code> on <a href="http://doc.qt.io/qt-5/internationalization.html#macos">macOS</a> or Linux. And the <code>EPICS_BASE</code> environment variable is pointing to it. The <code>EPICS_HOST_ARCH</code> environment variable is assumed to be</p>
<div class="table"><table class="generic">
<thead><tr class="qt-style"><th >OS</th><th >EPICS_HOST_ARCH</th></tr></thead>
<tr valign="top" class="odd"><td >Windows</td><td >windows-x64</td></tr>
<tr valign="top" class="even"><td ><a href="http://doc.qt.io/qt-5/internationalization.html#macos">macOS</a></td><td >darwin-x86</td></tr>
<tr valign="top" class="odd"><td >Linux</td><td >linux-x86_64</td></tr>
</table></div>
<p><i>Note: If it is going to be used in Qt Quick Designer, different setup might be required on <a href="use-in-quickdesigner.html">Windows</a>. </i></p>
<a name="macos-or-linux"></a>
<h2 id="macos-or-linux">macOS or Linux</h2>
<ul>
<li>Get the source from github<pre class="cpp">$ git clone https:<span class="comment">//github.com/xiaoqiangwang/CSDataQuick</span></pre>
</li>
<li>Create an out-of-source build directory<pre class="cpp">$ mkdir CSDataQuick<span class="operator">-</span>build
$ cd CSDataQuick<span class="operator">-</span>build</pre>
</li>
<li>Use cmake to config the build<pre class="cpp">$ cmake <span class="operator">.</span><span class="operator">.</span><span class="operator">/</span>CSDataQuick</pre>
</li>
<li>Start the build process<pre class="cpp">$ make</pre>
</li>
</ul>
<a name="windows"></a>
<h2 id="windows">Windows</h2>
<ul>
<li>Get the source from github<pre class="cpp"><span class="operator">&gt;</span> git clone https:<span class="comment">//github.com/xiaoqiangwang/CSDataQuick</span></pre>
</li>
<li>Create an out-of-source build directory<pre class="cpp"><span class="operator">&gt;</span> mkdir CSDataQuick<span class="operator">-</span>build
<span class="operator">&gt;</span> cd CSDataQuick<span class="operator">-</span>build</pre>
</li>
<li>Add Visual C++, Qt SDK, EPICS base to the <code>PATH</code><pre class="cpp"><span class="operator">&gt;</span> set PATH<span class="operator">=</span><span class="operator">%</span>PATH<span class="operator">%</span>;C:\<span class="type"><a href="http://doc.qt.io/qt-5/qt.html">Qt</a></span>\<span class="number">5.9.4</span>\msvc2015_64\bin;C:\epics\base<span class="operator">-</span><span class="number">3.14.12</span>\bin\windows<span class="operator">-</span>x64
<span class="operator">&gt;</span> call <span class="string">&quot;C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat&quot;</span> amd64</pre>
</li>
<li>Use cmake to config the build<pre class="cpp"><span class="operator">&gt;</span> <span class="string">&quot;C:\Program Files\CMake\bin\cmake&quot;</span> <span class="operator">-</span>DCMAKE_BUILD_TYPE<span class="operator">=</span>Release <span class="operator">-</span>G <span class="string">&quot;NMake Makefiles&quot;</span> <span class="operator">.</span><span class="operator">.</span>\CSDataQuick</pre>
</li>
<li>Start the build process<pre class="cpp"><span class="operator">&gt;</span> nmake</pre>
</li>
</ul>
</div>
<!-- @@@installation.html -->
</div>
</div>
</div>
</div>
</div>
<div class="footer">Copyright (C) 2012-2021 Xiaoqiang Wang, Paul Scherrer Institute.</div>
</body>
</html>