From 5fbe260778013c2deca985d0c8048eab07b7a4c7 Mon Sep 17 00:00:00 2001 From: Pliable Pixels Date: Wed, 2 Sep 2020 08:32:39 -0400 Subject: #963 fix build instructions --- docs/guides/source.rst | 50 ++++++++++++++++++++++++-------------------------- www/js/EventServer.js | 1 + 2 files changed, 25 insertions(+), 26 deletions(-) diff --git a/docs/guides/source.rst b/docs/guides/source.rst index c1f62f1a..70ac4b6c 100644 --- a/docs/guides/source.rst +++ b/docs/guides/source.rst @@ -58,54 +58,50 @@ Install Dependencies - needed for all platforms Install NodeJS ~~~~~~~~~~~~~~ -Install NodeJS from `here `__. As of -Dec 2018, I'm using Node ``v8.11.2``. I use -`n `__ to manage node versions and switch -between them. +I use `nvm `__ to install NodeJS. It allows you to +easily switch node versions. Follow their instructions and use the same node major +version you see above (12.x). Note that it is entirely possible another version of +node works. This is the only one I've tested with. I don't think minot version changes +will cause issues (example, ``12.18`` etc.). Install cordova and ionic ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. code:: bash - npm install -g cordova@8.1.2 ionic + npm install -g cordova@9.0.0 @ionic/cli npm install @ionic/v1-toolkit --save-dev - -Don't install later versions of cordova. I found compilation issues with cordova 9. - -And some more: - -.. code:: bash - - npm install -g gulp - npm install node-sass - npm install async - npm install jshint + npm install -g cordova-res + gem install cocoapods +If you don't have ``gem`` that means you need to install ruby. Installing ruby +installs gobs of nonsense. Too bad. (Note you may need to do ``sudo`` depending on how your system is set up. It's `better you don't `__, but if you must, well, you must) -You also need to install ``cocoapods`` (some of the plugins depend on them): +Download zmNinja +---------------- .. code:: bash - sudo gem install cocoapods + git clone --depth 1 https://github.com/pliablepixels/zmNinja.git -If you don't have ``gem`` that means you need to install ruby. Installing ruby -installs gobs of nonsense. Too bad. -Download zmNinja ----------------- +Add some more build deps: .. code:: bash - git clone --depth 1 https://github.com/pliablepixels/zmNinja.git + npm install -g gulp + npm install node-sass + npm install async + npm install jshint + -Configure build configure zmNinja and get all required plugins --------------------------------------------------------------- +Prepare for a build +---------------------------- .. code:: bash @@ -115,6 +111,7 @@ Configure build configure zmNinja and get all required plugins ionic cordova platform add android (or ios) cordova prepare + Making an iOS build ------------------- @@ -138,10 +135,11 @@ it support automatic building of notification extensions. So there is manual wor - Now in XCode Targets, select ``zmNinjaNotification``, and make sure you select a Team and make sure Deployment Target is 11 or above - Change Deployment target to 11 or above (same as zmNinja target) - ``cp etc/NotificationService.m platforms/ios/zmNinjaNotification/`` +- Please make sure you select the right development teams for both zmNinja and zmNinjaNotification so the app can be signed Starting 1.5.0, zmNinja uses the `cordova-plugin-firebasex `__ library for push notifications. The older cordova-push-plugin is no longer supported by the author. -If you are facing compilation issues that relate to this plugin, please make sure you read it's troubleshooting section, +If you are facing compilation issues that relate to this plugin, please make sure you read it's `install section `__, especially around outdated pods et. al. diff --git a/www/js/EventServer.js b/www/js/EventServer.js index 84260072..8dac402e 100644 --- a/www/js/EventServer.js +++ b/www/js/EventServer.js @@ -156,6 +156,7 @@ angular.module('zmApp.controllers') if (str.version == undefined) str.version = "0.1"; + //console.log ('************* COMPARING '+str.version+'to '+zm.minEventServerVersion); if (NVR.versionCompare(str.version, zm.minEventServerVersion) == -1) { $rootScope.zmPopup = $ionicPopup.alert({ title: $translate.instant('kEventServerVersionTitle'), -- cgit v1.2.3 From 4ba50c406287d769dfaaaedf6e56777347da9db0 Mon Sep 17 00:00:00 2001 From: Pliable Pixels Date: Wed, 2 Sep 2020 08:38:24 -0400 Subject: clarifications on isolating logs --- docs/guides/FAQ.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/guides/FAQ.rst b/docs/guides/FAQ.rst index cb67a498..e158c5e5 100644 --- a/docs/guides/FAQ.rst +++ b/docs/guides/FAQ.rst @@ -148,6 +148,17 @@ source code compile issues. How to report errors -------------------- +- In general, please try and localize the logs. It helps me pinpoint the issue. + Let's assume you have an issue where montage always shows green dots instead of images. + I'd recommend the following steps: + - Load up zmNinja + - Clear zmNinja logs + - Kill the app + - Load up zmNinja again and go to montage. I presume you are now looking at the error + - Go to logs, and email them to me via the email button on top (envelope icon) + Specifically, **don't do whole bunch of unrelated things and send me logs expecting me + to sift through and find out what is going on**. + - I don't know why something is not working if you don't provide sufficient inputs. Start by creating a `GitHub issue `__ and please -- cgit v1.2.3 From e54b8659ff385c667b7590bc383e8315769d47a7 Mon Sep 17 00:00:00 2001 From: Pliable Pixels Date: Thu, 3 Sep 2020 08:59:22 -0400 Subject: formatting --- docs/guides/FAQ.rst | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/guides/FAQ.rst b/docs/guides/FAQ.rst index e158c5e5..54c42198 100644 --- a/docs/guides/FAQ.rst +++ b/docs/guides/FAQ.rst @@ -151,6 +151,7 @@ How to report errors - In general, please try and localize the logs. It helps me pinpoint the issue. Let's assume you have an issue where montage always shows green dots instead of images. I'd recommend the following steps: + - Load up zmNinja - Clear zmNinja logs - Kill the app -- cgit v1.2.3