rhodes 3.3.5 → 3.4.2

data/doc/rhom.txt

@@ -767,6 +767,24 @@ Case|priority|4900dc4c072c|High|
 
 **NOTE: The column names are always the first line of the file.**
 
+## Importing and exporting the database
+You can export local database partition with all its blob objects to zip archive. Also you can import previously exported partition:
+
+### `Rhom::Rhom.database_export(partition)`
+
+	:::ruby
+	@path_to_zip_file = Rhom::Rhom.database_export('partition_name')
+
+Call to database_export will return local path to created archive with database and blob objects.
+
+### 'Rhom::Rhom.database_import(partition,zip)'
+
+	:::ruby
+	Rhom::Rhom.database_import('partition_name',@path_to_zip_file) 
+
+This will import database and blob objects from zip archive, created with 'database_export' call. If imported archive is inconsistent, or other failure will occur during import process, original database will be restored.
+
+
 ## Advanced Queries
 
 ### `find(*args)` (advanced conditions)
@@ -876,12 +894,15 @@ To use number comparison conditions in find use CAST :
         :conditions => ["CAST(rating as INTEGER)< ?", "#{size}"], :select => ['rating'] )
         
 ## Database Encryption
+
+**NOTE: As of Rhodes version 3.3.3, [Rhom data encryption](/rhodes/rhom#database-encryption) is removed from Rhodes. This feature is only supported in Motorola RhoMobile Suite. If you wish to use this feature, you will need to [upgrade to RhoMobile Suite](/rhoelements/rhoelements-install). Your application's build.yml will also need to be modified to [indicate the application type is 'Rhoelements']( /rhoelements/rhoelements2-native#enabling-motorola-device-capabilities). Additionally, a [RhoElements license](/rhoelements/licensing) is required.**
+
 If your application requires that the local database is encrypted on the filesystem, you can enable it by setting a flag in `build.yml`:
 
 	:::yaml
 	encrypt_database: 1
 
-**NOTE:  Database encryption is not supported for applications that use bulk sync at this time.**
+**NOTE: Database encryption is not supported for applications that use bulk sync at this time.**
 
 ### Platform Notes
 * iOS: Uses AES 128 encryption algorithm from iOS SDK.

data/doc/rhostudio-test-plan.txt

@@ -219,28 +219,85 @@ When you open the RhoStudio it asks a path to create (or open existing) `workspa
 1. Go to `Window > Preferences` (on Windows) or `RhoStudio > Preferences` (on Mac) in the top menu.
 2. Click on `Rhomobile` node, the message will appear: "Rhodes location is undefined. Please, open/create at least one Rhodes Application project".
 
-### Rhodes Application project creation test
-
-1. Go to `File > New > Project` in the top menu.
-2. Expand `Rhomobile` node, select `Rhodes application` and click `Next`.
-3. Leave all settings at their defaults and click `Finish`. Wait until the wizard finishes application generation.
-4. Something similar to the following output should appear in the Console window:
-       Generating with app generator:
-       [ADDED]   RhodesApplication1/rhoconfig.txt
-       [ADDED]   RhodesApplication1/build.yml
-       [ADDED]   RhodesApplication1/.gitignore
-       [ADDED]   RhodesApplication1/app/application.rb
-       [ADDED]   RhodesApplication1/app/index.erb
-       [ADDED]   RhodesApplication1/app/index.bb.erb
-       [ADDED]   RhodesApplication1/app/layout.erb
-       [ADDED]   RhodesApplication1/app/loading.html
-       [ADDED]   RhodesApplication1/Rakefile
-       [ADDED]   RhodesApplication1/app/helpers
-       [ADDED]   RhodesApplication1/icon
-       [ADDED]   RhodesApplication1/app/Settings
-       [ADDED]   RhodesApplication1/public
-       [ADDED]   RhodesApplication1/app/loading.png
-5. Check that project `RhodesApplication1` appeared at `Project Explorer` window.
+### RhoMobile Application project creation test
+
+1. RhoMobile Application project creation in workspace test
+
+1.1. Go to `File > New > Project` in the top menu.
+1.2. Expand `RhoMobile` node, select `RhoMobile application` and click `Next`.
+1.3. Leave all settings at their defaults and click `Finish`. Wait until the wizard finishes application generation.
+1.4. Something similar to the following output should appear in the Console view:
+PWD: /Users/sv/rhomobile/runtime-New_configuration
+CMD: rhoelements app RhoMobileApplication1
+Generating with app generator:
+ [32m     [ADDED] [0m  RhoMobileApplication1/rhoconfig.txt
+ [32m     [ADDED] [0m  RhoMobileApplication1/build.yml
+ [32m     [ADDED] [0m  RhoMobileApplication1/.gitignore
+ [32m     [ADDED] [0m  RhoMobileApplication1/app/application.rb
+ [32m     [ADDED] [0m  RhoMobileApplication1/app/index.erb
+ [32m     [ADDED] [0m  RhoMobileApplication1/app/index.bb.erb
+ [32m     [ADDED] [0m  RhoMobileApplication1/app/layout.erb
+ [32m     [ADDED] [0m  RhoMobileApplication1/app/loading.html
+ [32m     [ADDED] [0m  RhoMobileApplication1/Rakefile
+ [32m     [ADDED] [0m  RhoMobileApplication1/app/helpers
+ [32m     [ADDED] [0m  RhoMobileApplication1/icon
+ [32m     [ADDED] [0m  RhoMobileApplication1/app/Settings
+ [32m     [ADDED] [0m  RhoMobileApplication1/public
+ [32m     [ADDED] [0m  RhoMobileApplication1/app/loading.png
+RET: 0
+1.5. Check that project `RhoMobileApplication1` appeared at `Project Explorer` view.
+1.6. Check project files in `Project Explorer` view item.
+
+2. RhoMobile Application project creation in selected folder test
+
+2.1. Go to `File > New > Project` in the top menu.
+2.2. Expand `RhoMobile` node, select `RhoMobile application` and click `Next`.
+2.3. Clear 'Create application in default workspace' checkbox and select destination folder 
+     (press on Browse button and select folder in directory window).
+2.4  CLick `Finish` and wait until the wizard finishes application generation.
+2.5. Something similar to the following output should appear in the Console view:
+PWD: /Users/sv/tmp
+CMD: rhoelements app tmp
+Generating with app generator:
+ [32m     [ADDED] [0m  tmp/rhoconfig.txt
+ [32m     [ADDED] [0m  tmp/build.yml
+ [32m     [ADDED] [0m  tmp/.gitignore
+ [32m     [ADDED] [0m  tmp/app/application.rb
+ [32m     [ADDED] [0m  tmp/app/index.erb
+ [32m     [ADDED] [0m  tmp/app/index.bb.erb
+ [32m     [ADDED] [0m  tmp/app/layout.erb
+ [32m     [ADDED] [0m  tmp/app/loading.html
+ [32m     [ADDED] [0m  tmp/Rakefile
+ [32m     [ADDED] [0m  tmp/app/helpers
+ [32m     [ADDED] [0m  tmp/icon
+ [32m     [ADDED] [0m  tmp/app/Settings
+ [32m     [ADDED] [0m  tmp/public
+ [32m     [ADDED] [0m  tmp/app/loading.png
+RET: 0
+2.6. Check that project with given name appeared at `Project Explorer` view.
+2.7. Check project files in `Project Explorer` view item.
+
+3. RhoMoile Application project creation from existing sources test
+
+3.1. Create application outside of workspace by hand.
+3.2. Go to `File > New > Project` in the top menu.
+3.3. Expand `RhoMobile` node, select `RhoMobile application` and click `Next`.
+3.4. Enable 'Create application from existing sources' and select application folder 
+     (press on Browse button and select folder in directory window).
+3.5. Click `Finish` and wait until the wizard finishes.
+3.6. Check that project with given name appeared at `Project Explorer` view.
+3.7. Check project files in `Project Explorer` view item.
+
+4. RhoMoile Application project creation from existing sources in workspace test
+
+4.1. Create application in workspace by hand.
+4.2. Go to `File > New > Project` in the top menu.
+4.3. Expand `RhoMobile` node, select `RhoMobile application` and click `Next`.
+4.4. Enable 'Create application from existing sources' and select application folder in workspace  
+     (press on Browse button and select folder in directory window).
+4.5. Click `Finish` and wait until the wizard finishes.
+4.6. Check that project with given name appeared at `Project Explorer` view.
+4.7. Check project files in `Project Explorer` view item.
 
 ### Rhomobile Preferences editing success test
 

data/doc/simulator.txt

@@ -29,7 +29,7 @@ To run application in RhoSimulator just run in rhodes or application folder:
     rake run:wm:rhosimulator
     rake run:wp:rhosimulator
 
-    #run RhoSimulator to simulate 'UNKNOWN' platform:
+    #run RhoSimulator to simulate 'WINDOWS_DESKTOP' platform:
     rake run:win32:rhosimulator
 
 If you modified Rhodes application sources, just press 'Refresh' in RhoSimulator to reload application, i.e. generally no RhoSimulator restart is required.
@@ -67,50 +67,7 @@ Follow these instructions to build your own customized version of RhoSimulator.
 ### Preliminary steps for Windows
 
 * Currently only <b>Visual Studio 2008</b> is supported
-* Follow [Build for Windows - Prerequisites](build#build-for-windows), but do not install the Rhodes gem since you're going to use Rhodes SDK source.
-* Get the `rhodes` source (if haven't done it already) as described [here](build#setup-rhodes-source-code). Don't forget to add the `bin` folder to your path, run `rhodes-setup` and update Rhodes SDK path in `build.yml` at your application root folder.
-* First build the Qt libraries for VS 2008:
-    * Download the Qt source:
-        * Go to [http://qt.nokia.com/downloads](http://qt.nokia.com/downloads)
-        * Jump to `Qt libraries`
-        * Download the [source code as a zip](http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.7.4.zip) (237 MB)
-        * Extract the downloaded archive, e.g. into `C:\Qt\4.7.4`
-    * Prepare to build the OpenSSL library:
-        * Download [v1.0 source code](http://www.openssl.org/source/openssl-1.0.1.tar.gz) from [www.openssl.org](http://www.openssl.org/) and extract the downloaded archive, e.g. into `C:\Qt\openssl-1.0.1`
-        * Install Perl interpreter (if it's not installed yet), e.g. [ActiveState Perl](http://www.activestate.com/activeperl)
-        * Install [Netwide Assembler (NASM)](http://www.nasm.us/pub/nasm/releasebuilds/2.10/win32/nasm-2.10-installer.exe) from [www.nasm.us](http://www.nasm.us/) (if it's not installed yet)
-    * Open Control Panel » System » Advanced system settings » Environment Variables and then:
-        * Create new system variable `QTDIR` = `C:\Qt\4.7.4`
-        * Add to the `PATH` variable: `C:\Qt\4.7.4\bin;C:\Qt\openssl-1.0.1\bin` (it doesn't matter that `C:\Qt\openssl-1.0.1\bin` folder does not exist yet)
-        * Add to the `PATH` variable the path to `nasm.exe` (usually `C:\Program Files\nasm`)
-        * Either close all command prompts and Visual Studio instances, or reboot the computer so the new settings take effect.
-    * Open Visual Studio 2008 Command Prompt. This is accomplished using Start » All Programs » Microsoft Visual Studio 2008 » Visual Studio Tools » Visual Studio 2008 Command Prompt. Run in Visual Studio 2008 Command Prompt:
-
-			> vcvarsall.bat x86
-			> C:
-
-    * To build OpenSSL library run in the same command prompt:
-
-			> cd \Qt\openssl-1.0.1
-			> perl Configure VC-WIN32 enable-static-engine --prefix=C:/Qt/openssl-1.0.1
-			> ms\do_nasm
-			> nmake -f ms\ntdll.mak
-			> nmake -f ms\ntdll.mak install
-			> nmake -f ms\ntdll.mak clean
-
-    * To build Qt library run in the same command prompt:
-
-			> cd \Qt\4.7.4
-			> configure -opensource -platform win32-msvc2008
-			  -nomake examples -nomake demos -nomake docs
-			  -qt-libpng -qt-libjpeg -qt-libtiff -qt-libmng -qt-gif
-			  -openssl-linked -I C:/Qt/openssl-1.0.1/include
-			  -L C:/Qt/openssl-1.0.1/lib
-			> nmake
-			> nmake clean
-
-      Be aware that it will take a while to build the Qt libraries from sources (maybe few hours or so). Particularly the `configure` command may run for a few minutes, and the `nmake` command may run for a few hours.
-    * After the build process is completed exit Visual Studio 2008 Command Prompt
+* Follow [Build for Windows - Prerequisites](build#build-for-windows)
 
 ### Preliminary steps for Mac OS X
 
@@ -120,23 +77,33 @@ Follow these instructions to build your own customized version of RhoSimulator.
     * Download the Qt source:
         * Go to [http://qt.nokia.com/downloads](http://qt.nokia.com/downloads)
         * Jump to `Qt libraries`
-        * Download the [source code as a gzipped tar](http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.8.1.tar.gz) (229 MB)
-        * Extract the downloaded archive, e.g. into `~/qt-4.8.1`
+        * Download the [source code as a gzipped tar](http://releases.qt-project.org/qt4/source/qt-everywhere-opensource-src-4.8.2.tar.gz) (228 MB)
+        * Extract the downloaded archive, e.g. into `~/qt-4.8.2`
     * Make sure that your `PATH` environment variable does not contain the path to any previously installed Qt binaries
-    * Add to your `~/.profile` the new environment variable `QTDIR` by adding the line (or by changing the existing `QTDIR` variable):
+    * Add to your `~/.bash_profile` the new environment variable `QTDIR` by adding the line (or by changing the existing `QTDIR` variable):
 
 			export QTDIR=/Developer/SDKs/Qt
 
+    * Restart terminal windows to enable new environment setting.
+    * Patch Qt sources by replacing all occurences of '/Developer/SDKs/MacOSX10' to '.*MacOSX10' in two project files:
+        * `~/qt-4.8.2/src/3rdparty/webkit/Source/WebKit/qt/QtWebKit.pro`
+        * `~/qt-4.8.2/src/plugins/bearer/corewlan/corewlan.pro`
     * Open `Terminal.app` and issue commands:
 
-			$ cd ~/qt-4.8.1
+			$ cd ~/qt-4.8.2
 			$ ./configure -opensource -platform macx-g++
 			  -nomake examples -nomake demos -nomake docs
 			  -qt-libpng -qt-libjpeg -qt-libtiff -qt-libmng
-			  -webkit -prefix /Developer/SDKs/Qt -release
+			  -no-qt3support -webkit -release
+			  -prefix /Developer/SDKs/Qt
+			  -sdk /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.6.sdk
 			$ make
 			$ sudo make install
 
+      If you're using Xcode 4.2 or earlier, then change the last line of `./configure` command to:
+
+			  -sdk /Developer/SDKs/MacOSX10.6.sdk
+
       Be aware that it will take a while to build the Qt libraries from sources (maybe few hours or so).
 
 ### Enable bundled native extensions
@@ -160,9 +127,9 @@ To run Rhodes applications in the custom built RhoSimulator, please ensure that
 ### Build RhoSimulator for Windows in Visual Studio 2008:
 
 * Open the solution:
-  `C:\Rhomobile\rhodes\platform\wm\rhodes.sln`
+  `<path-to-ruby>\lib\ruby\gems\<version-number>\gems\rhodes-<version-number>\platform\wm\rhodes.sln`
 * Build solution for the configuration `SimulatorRelease|Win32`
 * Specify the path to custom built RhoSimulator at `rhobuild.yml`:
         env:
           paths:
-            rhosimulator: platform/wm/bin/Win32/rhodes/SimulatorRelease
+            rhosimulator: platform/wm/bin/win32/rhodes/SimulatorRelease

data/doc/standard-css.txt

@@ -54,7 +54,7 @@ The toolbar div supports three positions:
 <li><code>class="ui-btn-right"</code></li>
 </ul>
 
-Note that placing an item as the <code><a class="ui-btn-center>"</code> tag will prevent the page title from being displayed on the iPhone, and is not in compliance with Apple's human interface guidelines.
+Note that placing an item as the `<a class="ui-btn-center">` tag will prevent the page title from being displayed on the iPhone, and is not in compliance with Apple's human interface guidelines.
 If you wish to include more than two items in an application targeting iPhone, you may wish to add a secondary toolbar directly below the application toolbar.
 
 #### Toolbar Button Styles

data/doc/synchronization.txt

@@ -151,6 +151,8 @@ These parameters are included in all notifications.
  "download": when client start downloading database from server
  
  "change_db": when client start applying new database
+
+ "blobs": when client start downloading remote blob files
  
  "ok": when sync of partition finished without error
  

data/doc/test-log-debug.txt

@@ -91,7 +91,8 @@ Call the RhoLog error or info methods from a method in your Rhodes app:
 
 	:::ruby
 	def index
-		RhoLog.error("Some Category", "Some message")
+		RhoLog.error("Some Category", "Some error message")
+		RhoLog.info("Some Category", "Some info message")
 	end
 
 Additionally all common ruby output routines (like puts, print) are redirected to rhodes log with INFO level.
@@ -106,6 +107,18 @@ To enable remote logging just add the line to `rhoconfig.txt`:
 
 Then all log messages will be sent to the specified URL via POST HTTP-requests.
 
+You can also send log to remote server manually. To do this add following lines to rholog.txt:
+
+	logserver = 'http://<host>:<port>[/path]'
+	logname = '<log_name>'
+
+Then call RhoConfig.send_log:
+
+	:::ruby
+	def index
+		Rho::RhoConfig.send_log()
+	end
+
 ### RhoError class
 
 You may find access to the error class useful in logging and reporting:
@@ -133,3 +146,138 @@ See [Login/Logout Manager]() as an example.
 You can use the [RhoStudio debugger](/rhostudio.tutorial#using-the-debugger) to debug your Rhodes app. 
 
 
+## Profiling
+
+To perform performance measurements or found applications bottlenecks you can use RhoMobile Profiler tool.
+
+RhoMobile Profiler use performance counters to calculate execution time of specific function/code. There are 2 types of counters: global and local:
+
+* Global counters created once and can be stopped/started many times. When Global counter destroyed, it log accumulative time of all start/stop intervals.
+* Local counters can be stopped/started only once. While stopped, counter will log time interval between start and stop.
+
+### Profiler log.
+When Counter stopped (Local counters) or destroyed(Global counters) information from counter will be logged in the following format:
+
+(log prefix) PRFILER| (counter name)( (counter time) ): START/STOP
+
+For example:
+
+I 06/18/2012 23:27:20:311 00002ffc             PROFILER| BROWSER_PAGE (0:03:104) : STOP
+
+### Enable Profiler.
+Profiler is configurable at build time in build.yml file(Turned Off by default):
+
+    profiler: 1
+
+Will turn on Profiler
+
+After Profiler ON/OFF - full rebuild is required.
+
+### Built-in performance counters.
+
+These counters start working after you turn on Profiler in build.yml:
+
+* ERB_RENDER - ERB-file render (Ruby)
+* CTRL_ACTION - Controller action (Ruby)
+* INDEX_ACTION - Index page render
+* ERB_RENDER - ERB-file render (Ruby)
+* BROWSER_PAGE  - Browser page loading time (Native)
+* SyncEngine components has several native counters:
+
+    'Sync' - Full sync time
+    
+    'DB' - Time spend for database insert/update/delete while sync
+    
+    'Net' - Time spend for network communication while sync
+
+These counters works only if you create them in application. You can create counter in controller action and destroy it after some operations:
+
+* Sqlite database (Native)
+
+    'SQLITE' - counter for whole time processing SQL query including data conversion , sqlite3_step and prepare statement
+    
+    'SQLITE_EXEC' - sqlite3_step time only. 
+
+To Enable Ruby Garbage collector logging modify rhoconfig.txt(set log level to Trace):
+
+    MinSeverity = 0
+
+There are two Profiler API available: Ruby and Native(C/C++).
+
+### RhoProfiler Ruby module.
+
+RhoProfiler Ruby module will contain the following static methods:
+
+* create_counter(name) # Create Global counter
+* destroy_counter(name) #  Destroy Global counter
+* start_counter(name) # Start Local or Global counter. If Global counter with this name exist , this global counter will started. If no global counter exists, local counter will be created and started.
+
+* stop_counter(name) # Stop Global or local counter.
+* flush_counter(name, message) # Log information from counter(Local or Global). Counter does not stopped or started.
+
+* start_created_counter(name) # Counter will start only if it is already created previously(Global counter)
+
+Example of custom counter:
+
+	:::ruby
+	def index
+		RhoProfiler.create_counter('Counter1')
+
+        RhoProfiler.start_counter('Counter1')
+        function1()
+        RhoProfiler.stop_counter('Counter1')
+
+        #do something
+        
+        RhoProfiler.start_counter('Counter1')
+        function2()
+        RhoProfiler.stop_counter('Counter1')
+                            		
+		RhoProfiler.destroy_counter('Counter1') #Will log summary of function1 and function2 execution time
+	end
+
+Example using 'SQLITE' built-in counter:
+
+	:::ruby
+    def some_method
+
+     RhoProfiler.create_counter('SQLITE')
+
+     #do something: create/update objects for example
+
+     RhoProfiler.destroy_counter('SQLITE')
+
+    end
+ 
+### RhoProfiler C/C++ API.
+RhoProfiler C/C++ API contains several defines to manipulate Performance Counters.  Here is the list of defines:
+
+    //Global accumulative counters
+    #define PROF_CREATE_COUNTER(name)     // Create Global counter
+    #define PROF_DESTROY_COUNTER(name)    // Destroy Global counter
+    #define PROF_START(name) //Start Local or Global counter. If Global counter with this name exist , this global counter will started. If no global counter exists, local counter will be created and started.
+
+    #define PROF_STOP(name) // Stop Global or local counter. 
+    #define PROF_FLUSH_COUNTER(name,msg) //Log information from counter(Local or Global). Counter does not stopped or started. 
+    #define PROF_START_CREATED(name) //Counter will start only if it is already created previously(Global counter)
+
+Example:
+
+	:::ruby
+	#include "statistic/RhoProfiler.h"
+	void testFunction()
+	{
+		PROF_CREATE_COUNTER("Counter1");
+
+        PROF_START("Counter1");
+        function1();
+        PROF_STOP("Counter1");
+
+        //do something
+        
+        PROF_START("Counter1")
+        function2();
+        PROF_STOP("Counter1")
+                            		
+		PROF_DESTROY_COUNTER("Counter1") #Will log summary of function1 and function2 execution time
+	}

data/doc/ui.txt

@@ -170,6 +170,56 @@ In case you have jQueryMobile rendering broken on Windows Phone 7.0 you need to
 
 It should fix jQueryMobile rendering problems on Windows Phone 7.0 platform.
 
+#### White page flickering while transition
+It may happen if controller action method doesn't return any rendered value but performs [WebView.navigate(someUrl)](#control-webview-from-controller-actions) call instead.
+It is important to avoid using [WebView.navigate](#control-webview-from-controller-actions) in action methods because it is intended to be used in callback methods asynchronously.
+
+#### How to make an AJAX call and update page elements
+When one need to update some information on the page without any transition an AJAX call may be performed this way:
+
+    :::html
+    <div data-role="page">
+
+      <div data-role="header" data-position="inline">
+        <h1>AJAX sample</h1>
+      </div>
+
+      <div data-role="content">
+        <ul data-role="listview">
+          <li><p>To reset result just reload the page..</p></li>
+          <li>
+            <a href="#"
+               onclick="$.get('<%= url_for :action => :get_json %>').success(function(data){showResult(data)}); return false;">
+                    Read JSON object via AJAX call
+            </a>
+          </li>
+        </ul>
+      </div>
+
+      <div>A = <span id="result_a"></span></div>
+      <div>B = <span id="result_b"></span></div>
+      <div>C = <span id="result_c"></span></div>
+
+    </div>
+
+To handle AJAX request a controller action method can return JSON object this way:
+
+    ::::ruby
+    def get_json
+      render :string => '{"a": 1, "b": 2, "c": 3}'
+    end
+
+**NOTE: It is very important to don't use [WebView.execute_js](#control-webview-from-controller-actions) method to update some page elements.
+See next section for details.
+
+#### Improper using of WebView.execute_js method
+At the moment for most of mobile platforms it has been implemented via redirection to URL with 'javascript:' schema.
+
+In case it used in some AJAX call handler method in the controller it may lead to the situation where *success* javascript handler will never be executed.
+
+It may happen because at the moment of *success* handler should be executed an URL of the page already has been changed. It means no any handlers anymore from the previous page which are still valid.
+
+
 ## Loading screen
 
 Rhodes supports the display of a custom "Loading" screen while your application is launching. This screen's source is the file loading.html, located at <application-root>/app/loading.html.
@@ -254,6 +304,8 @@ Load from 'partials' folder:
 	
 ## Control WebView from controller actions
 It is possible to call on the WebView (browser) directly from your controllers. This API is recommended for use from callbacks, such as sync callback or camera callbacks.
+**NOTE: WebView do not support opening internet URLs required authentification. Use AsyncHTTP/AsyncHTTPS API for access to URL required authentification..
+
 
 Force WebView refresh current page
 	:::ruby
@@ -271,6 +323,8 @@ WebView.navigate supports an optional index parameter (defaults to 0, useful for
 	:::ruby
 	WebView.navigate(url, index)
 
+**NOTE: See [Important notes](#javascript-frameworks) section for details on possible issues with improper use of this method.
+
 Force WebView to navigate to previous page using Browser back
 	:::ruby
 	WebView.navigate_back
@@ -299,6 +353,7 @@ The same as above but for specified tab (if tab bar present)
 	#call method test on the tab page 
 	WebView.execute_js("test();", index) 
 
+**NOTE: See [Important notes](#javascript-frameworks) section for details on possible issues with improper use of this method.
 
 Returns index of @tabs array for the currently selected tab
 	:::ruby
@@ -399,6 +454,8 @@ The following is the default Rhodes menu if none is provided in application.rb:
 Here is list of allowed values for actions for user defined menus, toolbars and tabbars:
 
 * :back - do back navigation using web view history or application's back url
+**NOTE: Android: when press Back on application Home page, application  will exit
+
 * :forward - do forward navigation
 * :home - navigate to configured start_path
 * :options - navigate to configured options_path