diff options
Diffstat (limited to 'docs/_build/html/guides/source.html')
| -rw-r--r-- | docs/_build/html/guides/source.html | 77 |
1 files changed, 32 insertions, 45 deletions
diff --git a/docs/_build/html/guides/source.html b/docs/_build/html/guides/source.html index ce53f606..7430a695 100644 --- a/docs/_build/html/guides/source.html +++ b/docs/_build/html/guides/source.html @@ -97,18 +97,17 @@ </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-ios-build">Making an iOS build</a><ul> +<li class="toctree-l3"><a class="reference internal" href="#harder-if-you-need-picture-notification-support-in-push">(Harder) If you need picture notification support in push</a></li> +<li class="toctree-l3"><a class="reference internal" href="#easier-if-you-don-t-need-picture-notification-support-in-push">(Easier) If you don’t need picture notification support in push</a></li> +</ul> +</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> @@ -183,7 +182,7 @@ <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> +<a class="reference external" href="https://github.com/pliablepixels/releases">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> @@ -278,6 +277,31 @@ version</a></p> 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> +<div class="section" id="harder-if-you-need-picture-notification-support-in-push"> +<h3>(Harder) If you need picture notification support in push<a class="headerlink" href="#harder-if-you-need-picture-notification-support-in-push" title="Permalink to this headline">¶</a></h3> +<p>As of Mar 2019, cordova-ios does not support multiple targets, nor does +it support automatic building of notification extensions. So there is manual work to be done:</p> +<ul class="simple"> +<li>Open up <code class="docutils literal"><span class="pre">platforms/ios/zmNinja.xcworkspace</span></code> in XCode</li> +<li>Go to <code class="docutils literal"><span class="pre">File->New->Target->Notification</span> <span class="pre">Service</span> <span class="pre">Extension</span></code>, select Objective C</li> +<li>In the “Product Name” put in <code class="docutils literal"><span class="pre">zmNinjaNotification</span></code> (your BundleID should now read <code class="docutils literal"><span class="pre">com.pliablepixels.zmninja-pro.zmNinjaNotification</span></code>)</li> +<li>Say “Yes” to “Activate zmNinjaNotification scheme?” popup</li> +<li>Now go to zmNinjaNotification target and make version and build same as zmNinja</li> +<li>Now in XCode Targets, select <code class="docutils literal"><span class="pre">zmNinjaNotification</span></code>, and make sure you select a Team and make sure Deployment Target is 10 or above</li> +<li>Change Deployment target to 10.1 (same as zmNinja target)</li> +<li><code class="docutils literal"><span class="pre">`cp</span> <span class="pre">www/external/NotificationService.m</span> <span class="pre">platforms/ios/zmNinjaNotication/</span></code></li> +<li><code class="docutils literal"><span class="pre">cd</span> <span class="pre">platforms/ios/</span></code></li> +<li><code class="docutils literal"><span class="pre">pod</span> <span class="pre">install</span></code></li> +</ul> +<p>You can now do <cite>build_ios.sh</cite>. However, after you build, you will have to go back to XCode +after the build to make the following changes:</p> +<ol class="arabic simple"> +<li>Sync notification version with app version</li> +<li>Change notification bundle ID back to com.pliablepixels.zmninja-pro.zmNinjaNotification (cordova removes the last word)</li> +</ol> +</div> +<div class="section" id="easier-if-you-don-t-need-picture-notification-support-in-push"> +<h3>(Easier) If you don’t need picture notification support in push<a class="headerlink" href="#easier-if-you-don-t-need-picture-notification-support-in-push" title="Permalink to this headline">¶</a></h3> <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> @@ -301,6 +325,7 @@ 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> <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 @@ -346,44 +371,6 @@ to automate the build process better.</p> <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> |
