{"id":581,"date":"2018-07-27T09:50:22","date_gmt":"2018-07-27T09:50:22","guid":{"rendered":"http:\/\/fluentreports.com\/blog\/?p=581"},"modified":"2019-02-13T04:55:29","modified_gmt":"2019-02-13T04:55:29","slug":"nativescript-application-wide-android-runtime-settings","status":"publish","type":"post","link":"http:\/\/fluentreports.com\/blog\/?p=581","title":{"rendered":"NativeScript application wide runtime settings (updated 5.2)"},"content":{"rendered":"\n
\"NativeScript<\/a><\/figure><\/div>\n\n\n\n

On thing most people are probably not aware of is that the Android runtimes has a large number of knobs and switches to customize certain behavior of the engine.   I will try and list out all the current switches and knobs that you can use.   iOS now has one switch.<\/p>\n\n\n\n

First of all the settings go into the \/app\/package.json<\/strong>   If you open up the default package json you probably will see:<\/p>\n\n\n\n

{   \n    "android": {      \n        "v8Flags": "--expose_gc"    \n   },    \n   "main": "app.js",\n   "name": "tns-template-hello-world",\n   "version": "5.2.0"\n}<\/pre>\n\n\n\n
That \"android<\/strong>\" key is where everything goes for Android specific settings.   The default setting that comes in the files is "v8Flags": "--expose_gc"<\/code> this one is rather critical in that this enabled the runtime to call gc from JavaScript.   Now, there is quite a few v8Flags you can use; most the time they aren't needed but if you need to tune the v8 engine; you can add more flags into this string.  I even list a few in this post<\/a>.   Let me warn you again; DO NOT remove the \"--expose_gc\". <\/strong>  You will cause your app to crash when something attempts to call the GC from code.<\/p>\n\n\n\n
As of version 5.2;  there is a \"ios<\/strong>\" key called \"jscFlags<\/strong>\" option that is now available.   My recommendation while building\/testing your app is to add the key "ios": { "jscFlags":"--validateOptions=1" }<\/code> The jscFlags has items that can be used to tweak the JavaScript core engine.  You can find more flags here<\/a>.<\/p>\n\n\n\n
Ok, so here is the complete list of settings you can change in the Android section:<\/p>\n\n\n\n
Setting<\/strong><\/td>Default<\/strong><\/td>Min Version<\/strong><\/td>Description<\/strong><\/td><\/tr>
gcThrottleTime<\/td>0<\/td>3.x<\/td>Allows you to throttle 
how frequently JS GC 
triggers native GC
See:
Memory Management<\/a><\/td><\/tr>
memoryCheckInterval<\/td>0<\/td>3.x<\/td>How frequently to check
memory usage
See:
Memory Management<\/a><\/td><\/tr>
freeMemoryRatio<\/td>0.0<\/td>3.x<\/td>Ration of memory before a GC is ran (works with 
memoryCheckInterval)
See: 
Memory Management<\/a><\/td><\/tr>
markingMode<\/td>full<\/td>3.x<\/td>Switches which type of GC engine to use.\u00a0 \"none\" will enable a different engine which doesn't do 
marking.\u00a0 Typically faster 
for Angular apps<\/td><\/tr>
handleTimeZoneChanges<\/td>false<\/td>4.1<\/td>True<\/strong> will enable the 
ability for a time zone 
change in the settings to
effect the NS app.<\/td><\/tr>
maxLogcatObjectSize<\/td>1024<\/td>4.0<\/td>How many lines of text a
console output will log.<\/td><\/tr>
forceLog<\/td>false<\/td>4.0<\/td>True<\/strong> will enable logging 
in release mode<\/td><\/tr>
suppressCallJSMethodException<\/td>false<\/td>5.1<\/td>True<\/strong> will suppress the
boolean type conversion error from null that could randomly occur and crash the application.<\/td><\/tr>
codeCache<\/td>false<\/td>2.x<\/td>True<\/strong> - Enables code
caching in the v8 engine.<\/td><\/tr>
v8Flags<\/td>--expose_gc<\/td>1.x<\/td>Tunes the v8 engine<\/td><\/tr>
heapSnapshotBlob<\/td>\"\"<\/td>2.x<\/td>(Believe to be unused 
now)<\/td><\/tr>
heapSnapshotScript<\/td>\"\"<\/td>2.x<\/td>(Believe to be unused 
now)<\/td><\/tr>
snapshot.blob<\/td>\"\"<\/td>2.x<\/td>(Believe to be unused 
now)<\/td><\/tr>
profilerOutputDirKey<\/td>\"\"<\/td>2.x<\/td>(Believe to be unused 
now)<\/td><\/tr>
profiling<\/td>\"\"<\/td>2.x<\/td>(Believe to be unused 
now)<\/td><\/tr><\/tbody><\/table>\n\n\n\n
IOS Level Flags:<\/strong>\n<\/p>\n\n\n\n
Setting<\/strong><\/td>Default<\/strong><\/td>Min Version<\/strong><\/td>Description<\/strong><\/td><\/tr>
gcThrottleTime<\/td>0<\/td>5.2<\/td>Allows you to throttle 
how frequently JS GC 
triggers native GC
See: Custom Flags<\/a><\/td><\/tr>
memoryCheckInterval<\/td>0<\/td>5.2<\/td>How frequently to check memory usage
See: Custom Flags<\/a><\/td><\/tr>
freeMemoryRatio<\/td>0.0<\/td>5.2<\/td>Ration of memory before a GC is ran (works with
memoryCheckInterval)
See: Custom Flags<\/a><\/td><\/tr>
jscFlags<\/td>\"\"<\/td>5.2<\/td>Tunes the JavaScriptCore engine.  Valid Flags<\/a><\/td><\/tr><\/tbody><\/table>\n\n\n\n
Top Level Global Flags:<\/strong><\/p>\n\n\n\n
Setting<\/strong><\/td>Default<\/strong><\/td>Min Version<\/strong><\/td>Description<\/strong><\/td><\/tr>
discardUncaughtJsExceptions<\/td>false<\/td>4.2<\/td>True<\/strong> - will disable
crashing on JS errors, will
log any issues to console.<\/td><\/tr><\/tbody><\/table>\n\n\n\n
Recommended changes:<\/strong>
discardUncaughtJsExceptions: "true"<\/code> - This will keep the app from crashing on certain types of errors; this should be enabled for release mode! Some developers might find it more productive to have this enabled while coding to eliminate application crashes. Please note you MUST pay attention to the console if you enable this during development; because most JS errors that would crash out; will now be just logged to the console.<\/p>\n\n\n\n
suppressCallJSMethodExceptions: "true"<\/code> - This will keep the app from crashing on the boolean conversion issue that can occasionally occur.  This is not to say the app might have some other issue later; but this will eliminate a stupid (imho) crash reason.<\/p>\n\n\n\n
markingMode: "none"<\/code> - This will enable the experimental GC engine, this will help incredibly with Angular based apps. Please note it \"might\" cause more crashing errors if a plugin forgot to hold a reference to something it needed later. However with the above discardUncaughtJsExceptions<\/em> enabled; those errors won't crash the app.<\/p>\n\n\n\n
Late Breaking news; in 4.2 they actually moved \"discardUncaughtJsExceptions<\/strong>\" to the top level of the package; the reason why is because shortly after they added the support to Android; the support was added to iOS.  So now this flag controls both iOS and Android, so it no longer belongs just in the \"android<\/strong>\" block.<\/p>\n\n\n\n
So in your package json would look like this if you used my recommended settings:<\/p>\n\n\n\n
{\n   "android": {\n       "v8Flags": "--expose_gc",\n       "markingMode": "none",\n       "suppressCallKSMethodExceptions": "true"\n    },\n    "ios": {\n        "jscFlags": "--validateOptions=1"\n    },\n    "discardUncaughtJsExceptions": "true",\n    "main": "app.js",\n    "name": "tns-template-hello-world",\n    "version": "5.2.0"\n}<\/pre>\n\n\n\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
On thing most people are probably not aware of is that the Android runtimes has a large number of knobs and switches to customize certain behavior of the engine.   I will try and list out all the current switches and knobs that you can use.   iOS now has one switch. First of all the settings… Continue reading NativeScript application wide runtime settings (updated 5.2)<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_crdt_document":"","footnotes":""},"categories":[15,7,39],"tags":[17,16,117,116],"class_list":["post-581","post","type-post","status-publish","format-standard","hentry","category-nativescript","category-performance","category-tips","tag-android","tag-nativescript","tag-settings","tag-v8flags","entry"],"_links":{"self":[{"href":"http:\/\/fluentreports.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/581","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/fluentreports.com\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/fluentreports.com\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/fluentreports.com\/blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/fluentreports.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=581"}],"version-history":[{"count":19,"href":"http:\/\/fluentreports.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/581\/revisions"}],"predecessor-version":[{"id":684,"href":"http:\/\/fluentreports.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/581\/revisions\/684"}],"wp:attachment":[{"href":"http:\/\/fluentreports.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=581"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/fluentreports.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=581"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/fluentreports.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=581"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}