summaryrefslogtreecommitdiff
path: root/docs/_build/html/guides/source.html
diff options
context:
space:
mode:
authorPliable Pixels <pliablepixels@gmail.com>2019-03-15 09:27:24 -0400
committerPliable Pixels <pliablepixels@gmail.com>2019-03-15 09:27:24 -0400
commitb87f575ca55220a6d7066d6c96e6895ea4721e04 (patch)
tree2ec4f92c7d0433e002907dd0e984144146dcaf1e /docs/_build/html/guides/source.html
parent39af2422f657f8b5e53af59c7d0dd4fb8d741c38 (diff)
moved dirs
Diffstat (limited to 'docs/_build/html/guides/source.html')
-rw-r--r--docs/_build/html/guides/source.html468
1 files changed, 468 insertions, 0 deletions
diff --git a/docs/_build/html/guides/source.html b/docs/_build/html/guides/source.html
new file mode 100644
index 00000000..ce53f606
--- /dev/null
+++ b/docs/_build/html/guides/source.html
@@ -0,0 +1,468 @@
+
+
+<!DOCTYPE html>
+<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
+<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
+<head>
+ <meta charset="utf-8">
+
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+ <title>Building from Source &mdash; zmNinja documentation</title>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
+
+
+
+
+
+ <link rel="index" title="Index"
+ href="../genindex.html"/>
+ <link rel="search" title="Search" href="../search.html"/>
+ <link rel="top" title="zmNinja documentation" href="../index.html"/>
+ <link rel="next" title="Desktop port tips" href="desktop.html"/>
+ <link rel="prev" title="Validating APIs" href="validating-api.html"/>
+
+
+ <script src="../_static/js/modernizr.min.js"></script>
+
+</head>
+
+<body class="wy-body-for-nav" role="document">
+
+
+ <div class="wy-grid-for-nav">
+
+
+ <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+ <div class="wy-side-scroll">
+ <div class="wy-side-nav-search">
+
+
+
+ <a href="../index.html" class="icon icon-home"> zmNinja
+
+
+
+ </a>
+
+
+
+
+
+
+
+<div role="search">
+ <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
+ <input type="text" name="q" placeholder="Search docs" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+</div>
+
+
+ </div>
+
+ <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
+
+
+
+
+
+
+ <ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="FAQ.html">zmNinja FAQ</a></li>
+<li class="toctree-l1"><a class="reference internal" href="validating-api.html">Validating APIs</a></li>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Building from Source</a><ul>
+<li class="toctree-l2"><a class="reference internal" href="#install-dependencies-needed-for-all-platforms">Install Dependencies - needed for all platforms</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#install-nodejs">Install NodeJS</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#install-cordova-ionic-and-bower">Install cordova, ionic, and bower</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="#download-zmninja">Download zmNinja</a></li>
+<li class="toctree-l2"><a class="reference internal" href="#configure-build-configure-zmninja-and-get-all-required-plugins">Configure build configure zmNinja and get all required plugins</a></li>
+<li class="toctree-l2"><a class="reference internal" href="#making-an-ios-build">Making an iOS build</a></li>
+<li class="toctree-l2"><a class="reference internal" href="#making-an-android-build">Making an Android build</a></li>
+<li class="toctree-l2"><a class="reference internal" href="#making-a-desktop-build">Making a desktop build</a><ul>
+<li class="toctree-l3"><a class="reference internal" href="#for-versions-1-3-018-and-beyond">For versions 1.3.018 and beyond</a><ul>
+<li class="toctree-l4"><a class="reference internal" href="#make-sure-you-have-all-the-dependencies">Make sure you have all the dependencies</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="#set-up-desktop-dependencies">Set up desktop dependencies</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#first-time-setup">First time setup</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#make-the-desktop-build">Make the desktop build</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#running-desktop-builds">Running desktop builds</a></li>
+<li class="toctree-l3"><a class="reference internal" href="#subsequent-builds">Subsequent builds</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="#troubleshooting">Troubleshooting</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="desktop.html">Desktop port tips</a></li>
+<li class="toctree-l1"><a class="reference internal" href="contributing-language.html">Contributing a new language</a></li>
+</ul>
+
+
+
+ </div>
+ </div>
+ </nav>
+
+ <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
+
+
+ <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
+
+ <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+ <a href="../index.html">zmNinja</a>
+
+ </nav>
+
+
+
+ <div class="wy-nav-content">
+ <div class="rst-content">
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+<div role="navigation" aria-label="breadcrumbs navigation">
+
+ <ul class="wy-breadcrumbs">
+
+ <li><a href="../index.html">Docs</a> &raquo;</li>
+
+ <li>Building from Source</li>
+
+
+ <li class="wy-breadcrumbs-aside">
+
+
+ <a href="../_sources/guides/source.rst.txt" rel="nofollow"> View page source</a>
+
+
+ </li>
+
+ </ul>
+
+
+ <hr/>
+</div>
+ <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+ <div itemprop="articleBody">
+
+ <div class="section" id="building-from-source">
+<h1>Building from Source<a class="headerlink" href="#building-from-source" title="Permalink to this headline">¶</a></h1>
+<p><strong>NOTE</strong> If you want to run it on your desktop, you can directly
+download desktop binaries
+<a class="reference external" href="https://github.com/pliablepixels/zmNinja#desktop-platforms">here</a>
+and if you want it for Android/iOS you can get from the play/appstore.
+This is only for those who <em>want</em> to run from source.</p>
+<blockquote>
+<div>Note: If you are building from source, you are mostly on your own. I
+have very limited time to debug environment differences/package
+differences between what I have and what you may have. I’m not a
+nodejs/grunt etc expert and stuff seems to change all the time.</div></blockquote>
+<p>Version note: The code is compiled using the following versions of
+tools. <strong>If you are using newer versions of ionic the code may not
+compile - I don’t have the time to upgrade yet. Finally, if you choose
+to go the source route, I expect you to spend a lot of time yourself
+debugging first before you create an issue. Even if you do create an
+issue, I have very limited bandwidth to debug source compilation issues
+for you.</strong> Thanks.</p>
+<p>Output of <code class="docutils literal"><span class="pre">ionic</span> <span class="pre">info</span></code></p>
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">Ionic</span><span class="p">:</span>
+
+ <span class="n">ionic</span> <span class="p">(</span><span class="n">Ionic</span> <span class="n">CLI</span><span class="p">)</span> <span class="p">:</span> <span class="mf">4.5</span><span class="o">.</span><span class="mi">0</span> <span class="p">(</span><span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">local</span><span class="o">/</span><span class="n">lib</span><span class="o">/</span><span class="n">node_modules</span><span class="o">/</span><span class="n">ionic</span><span class="p">)</span>
+ <span class="n">Ionic</span> <span class="n">Framework</span> <span class="p">:</span> <span class="n">ionic1</span> <span class="mf">1.3</span><span class="o">.</span><span class="mi">5</span>
+ <span class="nd">@ionic</span><span class="o">/</span><span class="n">v1</span><span class="o">-</span><span class="n">toolkit</span> <span class="p">:</span> <span class="mf">1.0</span><span class="o">.</span><span class="mi">19</span>
+
+<span class="n">Cordova</span><span class="p">:</span>
+
+ <span class="n">cordova</span> <span class="p">(</span><span class="n">Cordova</span> <span class="n">CLI</span><span class="p">)</span> <span class="p">:</span> <span class="mf">8.1</span><span class="o">.</span><span class="mi">2</span> <span class="p">(</span><span class="n">cordova</span><span class="o">-</span><span class="n">lib</span><span class="nd">@8</span><span class="o">.</span><span class="mf">1.1</span><span class="p">)</span>
+ <span class="n">Cordova</span> <span class="n">Platforms</span> <span class="p">:</span> <span class="n">android</span> <span class="mf">7.1</span><span class="o">.</span><span class="mi">4</span><span class="p">,</span> <span class="n">ios</span> <span class="mf">5.0</span><span class="o">.</span><span class="mi">0</span>
+ <span class="n">Cordova</span> <span class="n">Plugins</span> <span class="p">:</span> <span class="n">cordova</span><span class="o">-</span><span class="n">plugin</span><span class="o">-</span><span class="n">ionic</span><span class="o">-</span><span class="n">keyboard</span> <span class="mf">2.1</span><span class="o">.</span><span class="mi">3</span><span class="p">,</span> <span class="n">cordova</span><span class="o">-</span><span class="n">plugin</span><span class="o">-</span><span class="n">ionic</span><span class="o">-</span><span class="n">webview</span> <span class="mf">2.2</span><span class="o">.</span><span class="mi">0</span><span class="p">,</span>
+<span class="p">(</span><span class="ow">and</span> <span class="mi">30</span> <span class="n">other</span> <span class="n">plugins</span><span class="p">)</span>
+
+<span class="n">System</span><span class="p">:</span>
+
+ <span class="n">Android</span> <span class="n">SDK</span> <span class="n">Tools</span> <span class="p">:</span> <span class="mf">26.1</span><span class="o">.</span><span class="mi">1</span> <span class="p">(</span><span class="o">/</span><span class="n">Users</span><span class="o">/</span><span class="n">pp</span><span class="o">/</span><span class="n">Library</span><span class="o">/</span><span class="n">Android</span><span class="o">/</span><span class="n">sdk</span><span class="o">/</span><span class="p">)</span>
+ <span class="n">ios</span><span class="o">-</span><span class="n">deploy</span> <span class="p">:</span> <span class="mf">2.0</span><span class="o">.</span><span class="mi">0</span>
+ <span class="n">ios</span><span class="o">-</span><span class="n">sim</span> <span class="p">:</span> <span class="mf">7.0</span><span class="o">.</span><span class="mi">0</span>
+ <span class="n">NodeJS</span> <span class="p">:</span> <span class="n">v8</span><span class="o">.</span><span class="mf">11.2</span> <span class="p">(</span><span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">local</span><span class="o">/</span><span class="nb">bin</span><span class="o">/</span><span class="n">node</span><span class="p">)</span>
+ <span class="n">npm</span> <span class="p">:</span> <span class="mf">5.6</span><span class="o">.</span><span class="mi">0</span>
+ <span class="n">OS</span> <span class="p">:</span> <span class="n">macOS</span> <span class="n">Mojave</span>
+ <span class="n">Xcode</span> <span class="p">:</span> <span class="n">Xcode</span> <span class="mf">10.1</span> <span class="n">Build</span> <span class="n">version</span> <span class="mi">10</span><span class="n">B61</span>
+</pre></div>
+</div>
+<div class="section" id="install-dependencies-needed-for-all-platforms">
+<h2>Install Dependencies - needed for all platforms<a class="headerlink" href="#install-dependencies-needed-for-all-platforms" title="Permalink to this headline">¶</a></h2>
+<div class="section" id="install-nodejs">
+<h3>Install NodeJS<a class="headerlink" href="#install-nodejs" title="Permalink to this headline">¶</a></h3>
+<p>Install NodeJS from <a class="reference external" href="https://nodejs.org/en/download/">here</a>. As of
+Dec 2018, I’m using Node <code class="docutils literal"><span class="pre">v8.11.2</span></code>. I use
+<a class="reference external" href="https://github.com/tj/n">n</a> to manage node versions and switch
+between them.</p>
+</div>
+<div class="section" id="install-cordova-ionic-and-bower">
+<h3>Install cordova, ionic, and bower<a class="headerlink" href="#install-cordova-ionic-and-bower" title="Permalink to this headline">¶</a></h3>
+<div class="code bash highlight-default"><div class="highlight"><pre><span></span><span class="n">npm</span> <span class="n">install</span> <span class="o">-</span><span class="n">g</span> <span class="n">cordova</span> <span class="n">ionic</span> <span class="n">bower</span>
+<span class="n">npm</span> <span class="n">install</span> <span class="nd">@ionic</span><span class="o">/</span><span class="n">v1</span><span class="o">-</span><span class="n">toolkit</span> <span class="o">--</span><span class="n">save</span><span class="o">-</span><span class="n">dev</span>
+</pre></div>
+</div>
+<p>And some more:</p>
+<div class="code bash highlight-default"><div class="highlight"><pre><span></span><span class="n">npm</span> <span class="n">install</span> <span class="o">-</span><span class="n">g</span> <span class="n">gulp</span>
+<span class="n">npm</span> <span class="n">install</span> <span class="n">node</span><span class="o">-</span><span class="n">sass</span>
+<span class="n">npm</span> <span class="n">install</span> <span class="k">async</span>
+<span class="n">npm</span> <span class="n">install</span> <span class="n">jshint</span>
+</pre></div>
+</div>
+<p>(Note you may need to do <code class="docutils literal"><span class="pre">sudo</span></code> depending on how your system is set
+up. It’s <a class="reference external" href="https://johnpapa.net/how-to-use-npm-global-without-sudo-on-osx/">better you
+don’t</a>,
+but if you must, well, you must)</p>
+<p>If you get a newer version, you should adjust your cordova version to
+the mentioned version above in order to be able to successfully compile
+zmNinja. To change the version you can follow these instructions:
+<a class="reference external" href="https://iphonedevlog.wordpress.com/2014/06/25/updating-and-reverting-to-different-cordova-phonegap-versions">change cordova
+version</a></p>
+</div>
+</div>
+<div class="section" id="download-zmninja">
+<h2>Download zmNinja<a class="headerlink" href="#download-zmninja" title="Permalink to this headline">¶</a></h2>
+<div class="code bash highlight-default"><div class="highlight"><pre><span></span><span class="n">git</span> <span class="n">clone</span> <span class="o">--</span><span class="n">depth</span> <span class="mi">1</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">github</span><span class="o">.</span><span class="n">com</span><span class="o">/</span><span class="n">pliablepixels</span><span class="o">/</span><span class="n">zmNinja</span><span class="o">.</span><span class="n">git</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="configure-build-configure-zmninja-and-get-all-required-plugins">
+<h2>Configure build configure zmNinja and get all required plugins<a class="headerlink" href="#configure-build-configure-zmninja-and-get-all-required-plugins" title="Permalink to this headline">¶</a></h2>
+<div class="code bash highlight-default"><div class="highlight"><pre><span></span><span class="n">cd</span> <span class="n">zmNinja</span>
+<span class="n">npm</span> <span class="n">install</span>
+<span class="n">bower</span> <span class="n">install</span>
+<span class="n">ionic</span> <span class="n">cordova</span> <span class="n">platform</span> <span class="n">add</span> <span class="n">android</span> <span class="p">(</span><span class="ow">or</span> <span class="n">ios</span><span class="p">)</span>
+<span class="n">cordova</span> <span class="n">prepare</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="making-an-ios-build">
+<h2>Making an iOS build<a class="headerlink" href="#making-an-ios-build" title="Permalink to this headline">¶</a></h2>
+<p>Note: You need to be doing this on a mac, with Xcode and the SDK
+installed. You also need to have your developer certificates/etc. (I am
+not going to detail this out - there are many internet resources on
+this)</p>
+<p>There are a few steps you need to take to get the iOS build working for
+the first time. If you don’t do this, you may get a compilation error
+that says <code class="docutils literal"><span class="pre">ld:</span> <span class="pre">library</span> <span class="pre">not</span> <span class="pre">found</span> <span class="pre">for</span> <span class="pre">-lGoogleToolboxForMac</span></code></p>
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">cd</span> <span class="n">platforms</span><span class="o">/</span><span class="n">ios</span>
+<span class="n">pod</span> <span class="n">install</span>
+</pre></div>
+</div>
+<p>This does not produce an iOS ready ipa. What you need to do then is to
+open <code class="docutils literal"><span class="pre">platforms/ios/zmNinja.xcworkspace</span></code> in Xcode, and run.</p>
+<p>To compile a debug build for iOS from command line, from zmNinja project
+root: First edit <code class="docutils literal"><span class="pre">./build-auto.json</span></code> and change the
+<code class="docutils literal"><span class="pre">developmentTeam</span></code> id to yours. Then:</p>
+<div class="code bash highlight-default"><div class="highlight"><pre><span></span><span class="o">./</span><span class="n">build_ios</span><span class="o">.</span><span class="n">sh</span>
+</pre></div>
+</div>
+<p>To compile using XCode, open <code class="docutils literal"><span class="pre">platforms/ios/zmNinja.xcworkspace</span></code> - You
+need to use “Legacy Build” system if you are on XCode 10+. You can
+change this in XCode <code class="docutils literal"><span class="pre">File-&gt;Workspace</span> <span class="pre">Settings</span></code> and then build usual.
+Also switch to the Capabilities tab and make sure “Remote Notifications”
+is on in Background Modes and in iCloud section, Key-Value storage is
+enabled. If you see a “Fix issue” there, clicking on that button
+resolves everything.</p>
+</div>
+<div class="section" id="making-an-android-build">
+<h2>Making an Android build<a class="headerlink" href="#making-an-android-build" title="Permalink to this headline">¶</a></h2>
+<p>Note that you need the <a class="reference external" href="http://developer.android.com/sdk/index.html">Android
+SDK</a> installed and
+configured properly for this to work.</p>
+<p>From the zmNinja project root:</p>
+<div class="code bash highlight-default"><div class="highlight"><pre><span></span><span class="o">./</span><span class="n">build_android</span><span class="o">.</span><span class="n">sh</span> <span class="o">--</span><span class="n">debug</span> <span class="p">(</span><span class="ow">or</span> <span class="o">--</span><span class="n">release</span><span class="p">)</span>
+</pre></div>
+</div>
+<p>If this complains of missing SDKs, you need to install the SDK version
+it requests This should produce an APK file. To install it on your phone
+over adb, you’d do something like</p>
+<div class="code bash highlight-default"><div class="highlight"><pre><span></span><span class="n">adb</span> <span class="n">install</span> <span class="o">-</span><span class="n">r</span> <span class="n">debug_files</span><span class="o">/</span><span class="n">android</span><span class="o">-</span><span class="n">debug</span><span class="o">.</span><span class="n">apk</span> <span class="c1">#if you did --debug</span>
+<span class="ow">or</span><span class="p">,</span>
+<span class="n">adb</span> <span class="n">install</span> <span class="o">-</span><span class="n">r</span> <span class="n">release_files</span><span class="o">/</span><span class="n">zmNinja</span><span class="o">.</span><span class="n">apk</span> <span class="c1">#if you did --release</span>
+</pre></div>
+</div>
+</div>
+<div class="section" id="making-a-desktop-build">
+<h2>Making a desktop build<a class="headerlink" href="#making-a-desktop-build" title="Permalink to this headline">¶</a></h2>
+<p>I use <a class="reference external" href="https://electron.atom.io">electron</a> to build the desktop app.</p>
+<div class="section" id="for-versions-1-3-018-and-beyond">
+<h3>For versions 1.3.018 and beyond<a class="headerlink" href="#for-versions-1-3-018-and-beyond" title="Permalink to this headline">¶</a></h3>
+<p>I’ve migrated to using
+<a class="reference external" href="https://github.com/electron-userland/electron-builder">electron-builder</a>
+to automate the build process better.</p>
+<div class="section" id="make-sure-you-have-all-the-dependencies">
+<h4>Make sure you have all the dependencies<a class="headerlink" href="#make-sure-you-have-all-the-dependencies" title="Permalink to this headline">¶</a></h4>
+<p>Typically, just running</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">npm</span> <span class="n">install</span>
+<span class="n">bower</span> <span class="n">install</span>
+</pre></div>
+</div>
+<p>Should have installed everything. Validate by checking you have
+<code class="docutils literal"><span class="pre">electron</span></code> installed by invoking it on the command line</p>
+<p>You now have the following options:</p>
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">npm</span> <span class="n">run</span> <span class="n">dist</span><span class="o">-</span><span class="nb">all</span> <span class="c1"># builds linux, mac and windows packages</span>
+<span class="n">npm</span> <span class="n">run</span> <span class="n">dist</span><span class="o">-</span><span class="n">mac</span> <span class="c1"># only builds mac packages</span>
+<span class="n">npm</span> <span class="n">run</span> <span class="n">dist</span><span class="o">-</span><span class="n">lin</span> <span class="c1"># only builds linux packages (32bit, 64bit, arm)</span>
+<span class="n">npm</span> <span class="n">run</span> <span class="n">dist</span><span class="o">-</span><span class="n">win</span> <span class="c1"># only builds win packages (32bit, 64bit)</span>
+</pre></div>
+</div>
+<p>Your packages will be created in the <code class="docutils literal"><span class="pre">dist</span></code> folder</p>
+</div>
+</div>
+<div class="section" id="set-up-desktop-dependencies">
+<h3>Set up desktop dependencies<a class="headerlink" href="#set-up-desktop-dependencies" title="Permalink to this headline">¶</a></h3>
+<div class="code bash highlight-default"><div class="highlight"><pre><span></span><span class="n">npm</span> <span class="n">install</span> <span class="o">-</span><span class="n">g</span> <span class="n">electron</span>
+<span class="n">npm</span> <span class="n">install</span> <span class="o">-</span><span class="n">g</span> <span class="n">asar</span>
+</pre></div>
+</div>
+<p>Make sure <code class="docutils literal"><span class="pre">electron</span></code> is installed. You should be able to do a
+<code class="docutils literal"><span class="pre">which</span> <span class="pre">electron</span></code></p>
+<p>Also make sure <code class="docutils literal"><span class="pre">unzip</span></code> and <code class="docutils literal"><span class="pre">wget</span></code> tools are installed in your
+system.</p>
+</div>
+<div class="section" id="first-time-setup">
+<h3>First time setup<a class="headerlink" href="#first-time-setup" title="Permalink to this headline">¶</a></h3>
+<p>If this is the first time you are building a desktop version, you need
+to download electron images for various platforms. There is a helper
+script called <code class="docutils literal"><span class="pre">prepare_desktop.sh</span></code> that you can run. This creates a
+directory called <code class="docutils literal"><span class="pre">desktop</span></code> inside your zmNinja directory. It currently
+downloads all supported platforms.</p>
+<div class="code bash highlight-default"><div class="highlight"><pre><span></span><span class="o">./</span><span class="n">prepare_desktop</span><span class="o">.</span><span class="n">sh</span>
+</pre></div>
+</div>
+<p>This will download a bunch of files. If completed successfully, you can
+proceed to the next step.</p>
+</div>
+<div class="section" id="make-the-desktop-build">
+<h3>Make the desktop build<a class="headerlink" href="#make-the-desktop-build" title="Permalink to this headline">¶</a></h3>
+<p>Once you are done with <code class="docutils literal"><span class="pre">prepare_desktop.sh</span></code>, you can do a
+<code class="docutils literal"><span class="pre">./make_desktop.sh</span></code>. This will actually build images for all
+platforms.</p>
+</div>
+<div class="section" id="running-desktop-builds">
+<h3>Running desktop builds<a class="headerlink" href="#running-desktop-builds" title="Permalink to this headline">¶</a></h3>
+<p><code class="docutils literal"><span class="pre">cd</span></code> into the desktop directory and run whichever port you want</p>
+</div>
+<div class="section" id="subsequent-builds">
+<h3>Subsequent builds<a class="headerlink" href="#subsequent-builds" title="Permalink to this headline">¶</a></h3>
+<p>You need to <code class="docutils literal"><span class="pre">./make_desktop.sh</span></code> each time you make changes.</p>
+</div>
+</div>
+<div class="section" id="troubleshooting">
+<h2>Troubleshooting<a class="headerlink" href="#troubleshooting" title="Permalink to this headline">¶</a></h2>
+<p>Lots of things can go wrong. * Please make sure you don’t post issues
+about why your own build is not working - please figure it out * Look
+carefully at error messages</p>
+</div>
+</div>
+
+
+ </div>
+ <div class="articleComments">
+
+ </div>
+ </div>
+ <footer>
+
+ <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
+
+ <a href="desktop.html" class="btn btn-neutral float-right" title="Desktop port tips" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right"></span></a>
+
+
+ <a href="validating-api.html" class="btn btn-neutral" title="Validating APIs" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left"></span> Previous</a>
+
+ </div>
+
+
+ <hr/>
+
+ <div role="contentinfo">
+ <p>
+ &copy; Copyright 2019, Pliable Pixels.
+
+ </p>
+ </div>
+ Built with <a href="http://sphinx-doc.org/">Sphinx</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
+
+</footer>
+
+ </div>
+ </div>
+
+ </section>
+
+ </div>
+
+
+
+
+
+ <script type="text/javascript">
+ var DOCUMENTATION_OPTIONS = {
+ URL_ROOT:'../',
+ VERSION:'',
+ COLLAPSE_INDEX:false,
+ FILE_SUFFIX:'.html',
+ HAS_SOURCE: true,
+ SOURCELINK_SUFFIX: '.txt'
+ };
+ </script>
+ <script type="text/javascript" src="../_static/jquery.js"></script>
+ <script type="text/javascript" src="../_static/underscore.js"></script>
+ <script type="text/javascript" src="../_static/doctools.js"></script>
+
+
+
+
+
+ <script type="text/javascript" src="../_static/js/theme.js"></script>
+
+
+
+
+ <script type="text/javascript">
+ jQuery(function () {
+ SphinxRtdTheme.StickyNav.enable();
+ });
+ </script>
+
+
+</body>
+</html> \ No newline at end of file