rhodes 3.4.2 → 3.5.1.12

data/CHANGELOG

@@ -1,3 +1,12 @@
+## 3.4.2
+* iPhone: support iOS 6 and XCode 4.5
+* Fix several Windows Phone 7 issues
+* Add System.zip_file and System.zip_files methods to iPhone, Android and Windows
+* Support zlib library extension for iPhone, Android and Windows
+* Support openssl, digest-sha2 and ezcrypto libraries for iPhone, Android and Windows
+* Fix Blackberry 4.6 build
+* Fix several issues in RhoConnect client related to bulk and blob synchronization
+
 ## 3.3.3
 * Support freezed models (FixedSchema and PropertyBag)
 * Detect available network types

data/Rakefile

@@ -62,6 +62,7 @@ load File.join(pwd, 'platform/iphone/rbuild/iphone.rake')
 load File.join(pwd, 'platform/wm/build/wm.rake')
 load File.join(pwd, 'platform/linux/tasks/linux.rake')
 load File.join(pwd, 'platform/wp7/build/wp.rake')
+load File.join(pwd, 'platform/wp8/build/wp.rake')
 load File.join(pwd, 'platform/symbian/build/symbian.rake')
 load File.join(pwd, 'platform/osx/build/osx.rake')
 
@@ -94,7 +95,7 @@ namespace "framework" do
 end
 
 
-$application_build_configs_keys = ['security_token', 'encrypt_database', 'android_title', 'iphone_db_in_approot', 'iphone_set_approot', 'iphone_userpath_in_approot', "motorola_license", "motorola_license_company"]
+$application_build_configs_keys = ['security_token', 'encrypt_database', 'android_title', 'iphone_db_in_approot', 'iphone_set_approot', 'iphone_userpath_in_approot', "motorola_license", "motorola_license_company","name"]
 
 def make_application_build_config_header_file
   f = StringIO.new("", "w+")      
@@ -217,6 +218,7 @@ end
 
 def update_rhoprofiler_java_file
     use_profiler = $app_config['profiler'] || ($app_config[$current_platform] && $app_config[$current_platform]['profiler'])
+    use_profiler = use_profiler && use_profiler.to_i() != 0 ? true : false
     
     content = ""
     File.open( File.join( $startdir, "platform/bb/RubyVM/src/com/rho/RhoProfiler.java" ), 'rb' ){ |f| content = f.read() }
@@ -237,6 +239,7 @@ end
 
 def update_rhodefs_header_file
     use_profiler = $app_config['profiler'] || ($app_config[$current_platform] && $app_config[$current_platform]['profiler'])
+    use_profiler = use_profiler && use_profiler.to_i() != 0 ? true : false
     
     content = ""
     File.open( File.join( $startdir, "platform/shared/common/RhoDefs.h" ), 'rb' ){ |f| content = f.read() }
@@ -378,6 +381,20 @@ namespace "config" do
         end
     end
 
+    # add rawsensors extension for rhoelements app
+    if $current_platform == "iphone" || $current_platform == "android"
+        if $app_config["app_type"] == 'rhoelements'
+            if !$app_config['extensions'].index('rhoelementsext')
+                $app_config["extensions"] += ["rawsensors"] unless $app_config['extensions'].index('rawsensors')
+                $app_config["extensions"] += ["audiocapture"] unless $app_config['extensions'].index('audiocapture')
+            end
+        end
+    end
+    if $app_config['extensions'].index('rhoelementsext')
+        $app_config["extensions"].delete("rawsensors")
+        $app_config["extensions"].delete("audiocapture")
+    end
+
     $hidden_app = $app_config["hidden_app"].nil?() ? "0" : $app_config["hidden_app"]
     
     #application build configs
@@ -404,6 +421,14 @@ namespace "config" do
         #$app_config['extensions'].delete('nfc')
         $rhoelements_features += "- NFC extension\n"
     end
+    if $app_config['extensions'].index('rawsensors')
+        #$app_config['extensions'].delete('rawsensors')
+        $rhoelements_features += "- Raw Sensors\n"
+    end
+    if $app_config['extensions'].index('audiocapture')
+        #$app_config['extensions'].delete('audiocapture')
+        $rhoelements_features += "- Audio Capture\n"
+    end
     
     if $current_platform == "wm"
         $rhoelements_features += "- Windows Mobile/Windows CE platform support\n"
@@ -426,6 +451,10 @@ namespace "config" do
         $rhoelements_features += "- Motorola WebKit Browser\n"                
     end
 
+    if $app_config['extensions'].index('rho-javascript')
+        $rhoelements_features += "- Javascript API for device capabilities\n"                
+    end
+
     if File.exist?(File.join($app_path, "license.yml"))
         license_config = Jake.config(File.open(File.join($app_path, "license.yml")))    
     
@@ -462,6 +491,15 @@ namespace "config" do
             if $app_config['extensions'].index('nfc')
                 $app_config['extensions'].delete('nfc')
             end
+            if $app_config['extensions'].index('rawsensors')
+                $app_config['extensions'].delete('rawsensors')
+            end
+            if $app_config['extensions'].index('audiocapture')
+                $app_config['extensions'].delete('audiocapture')
+            end
+            if $app_config['extensions'].index('rho-javascript')
+                $app_config['extensions'].delete('rho-javascript')
+            end
             
             if $application_build_configs['encrypt_database'] && $application_build_configs['encrypt_database'].to_s == '1'
                 $application_build_configs.delete('encrypt_database')
@@ -598,8 +636,18 @@ def add_extension(path,dest)
   start = pwd
   chdir path if File.directory?(path)
 
-  Dir.glob("*").each { |f| cp_r f,dest unless f =~ /^ext(\/|(\.yml)?$)/ }
+  Dir.glob("*").each do |f| 
+    cp_r f,dest unless f =~ /^ext(\/|(\.yml)?$)/ || f =~ /^app/  || f =~ /^public/
+  end  
 
+  if $current_platform == "bb"
+    cp_r 'app', File.join( dest, "apps/app" ) if File.exist? 'app'
+    cp_r 'public', File.join( dest, "apps/public" ) if File.exist? 'public'
+  else
+    cp_r 'app', File.join( File.dirname(dest), "apps/app" ) if File.exist? 'app'
+    cp_r 'public', File.join( File.dirname(dest), "apps/public" ) if File.exist? 'public'
+  end
+  
   chdir start
 end
 
@@ -622,13 +670,10 @@ def init_extensions(startdir, dest)
       end
     end    
     
-    puts '1'
-
     if extpath.nil?
       begin
         $rhodes_extensions = nil
         require extname
-        puts '1-2'
         if $rhodes_extensions
             extpath = $rhodes_extensions[0]
             $app_config["extpaths"] << extpath
@@ -819,7 +864,13 @@ def common_bundle_start(startdir, dest)
   start = pwd
   chdir rhodeslib
 
-  Dir.glob("*").each { |f| cp_r f,dest, :preserve => true }
+  Dir.glob("*").each { |f|
+    if f.to_s == "autocomplete"
+      next
+    end
+          
+    cp_r f,dest, :preserve => true 
+  }
 
   chdir dest
   Dir.glob("**/rhodes-framework.rb").each {|f| rm f}
@@ -876,7 +927,7 @@ def common_bundle_start(startdir, dest)
 
   replace_platform = $config['platform']
   replace_platform = "bb6" if $bb6
-  replace_platform = "wm" if replace_platform == 'win32'
+  #replace_platform = "wm" if replace_platform == 'win32'
 
   [File.join($srcdir,'apps'), ($current_platform == "bb" ? File.join($srcdir,'res') : File.join($srcdir,'lib/res'))].each do |folder|
       chdir folder
@@ -888,7 +939,8 @@ def common_bundle_start(startdir, dest)
       end
       
       Dir.glob("**/*.wm.*").each { |f| rm f }
-	    Dir.glob("**/*.wp7.*").each { |f| rm f }
+	  Dir.glob("**/*.wp7.*").each { |f| rm f }
+	  Dir.glob("**/*.wp8.*").each { |f| rm f }
       Dir.glob("**/*.iphone.*").each { |f| rm f }
       Dir.glob("**/*.bb.*").each { |f| rm f }
       Dir.glob("**/*.bb6.*").each { |f| rm f }
@@ -912,7 +964,7 @@ def process_exclude_folders
 
   exclude_platform = $config['platform']
   exclude_platform = "bb6" if $bb6
-  exclude_platform = "wm" if exclude_platform == 'win32'
+  #exclude_platform = "wm" if exclude_platform == 'win32'
 
   if $app_config["excludedirs"]
       excl += $app_config["excludedirs"]['all'] if $app_config["excludedirs"]['all']

data/doc/build.txt

@@ -226,12 +226,12 @@ The default build.yml settings generated for iphone are:
 * emulatortarget: device family for simulator (iphone/ipad)
 * BundleIdentifier: bundle identifier - used in provisioning profile 
 * BundleURLScheme: bundle URL scheme of your app (used for opening your application from another application by using custom URL scheme)
-* entitlements_file: path of your custom Entitlements.plist (if you want use own instead of default) - you also can just put Entitlements.plist file into root folder of your application and it will be automaticallly used during build
+* entitlements_file: path of your custom Entitlements.plist (if you want use own instead of default) - you also can just put Entitlements.plist file into root folder of your application and it will be automatically used during build
 * production: section used only for Ad Hoc distribution, contain some specific options for prepare .plist and *.ipa files etc.
 * app_plist_title: title in plist file (application name by default)
 * app_plist_subtitle: subtitle in plist file (application name by default)
-* app_plist_icon_url: icon url writed in plist file
-* app_plist_ipa_url: IPA file url writed in plist file
+* app_plist_icon_url: icon url written in plist file
+* app_plist_ipa_url: IPA file url written in plist file
 * ipa_itunesartwork_image: path to iTunesArtwork image included into IPA file (must be 512x512 JPG image) 
 
 
@@ -277,6 +277,8 @@ Use <b>iTunes</b> for installing your application package (your_application_name
 
 ## Build for Android
 
+**NOTE: To build for Android it is required JDK 1.6 (JDK 1.7 is not supported).**
+
 ### Setting Up the Android SDK and NDK
 
 Check that your [OS is compatible with the Android SDK](http://developer.android.com/sdk/requirements.html).
@@ -294,7 +296,7 @@ Download and unzip the [Android NDK](http://developer.android.com/sdk/ndk/index.
 
 ** NOTE: You need to update Android SDK platforms and Android NDK to latest ones as you update to new rhodes **
 
-In RhoStudio -> Preferences on the Macintosh or Winndows -> Preferences on Windows, open Rhomobile->Android and set the paths to your Android SDK and NDK installations.
+In RhoStudio -> Preferences on the Macintosh or Windows -> Preferences on Windows, open Rhomobile->Android and set the paths to your Android SDK and NDK installations.
 
 <img src="http://rhodocs.s3.amazonaws.com/rhostudio-tutorial/preferences-android-sdk.png"/>
 
@@ -309,7 +311,7 @@ In case you are planning to work with native geo mapping (the MapView interface)
 	android:
 	  apikey: "GOOGLE-API-KEY-FOR-ANDROID"
 
-* Enable 'mapping' in your application's `build.yml` (or in `<rhodes-root>/rhobuild.yml`). In RhoStudio, you can double-click on your application's build.yml and edit from the text editor; otherwise, you can edit rhobuil.yml or build.yml from another text editor.
+* Enable 'mapping' in your application's `build.yml` (or in `<rhodes-root>/rhobuild.yml`). In RhoStudio, you can double-click on your application's build.yml and edit from the text editor; otherwise, you can edit rhobuild.yml or build.yml from another text editor.
 
 	android:
 	  mapping: yes
@@ -333,13 +335,13 @@ Otherwise your css files will not be loaded in Android 1.5 (and higher).
 
 ### Device capabilities settings in build.yml
 
-On Android, you must specify your device capabilities the your application will use. By default, these capabiliteis are NOT enabled.
+On Android, you must specify your device capabilities the your application will use. By default, these capabilities are NOT enabled.
 
 In RhoStudio, you can double-click on your application's build.yml file, then click the Rhobuild setting tab, then click the Capabilities: Add button. You will see a list of capabilities you can check to activate for your application.
 
 <img src="http://rhodocs.s3.amazonaws.com/rhostudio-tutorial/select-capabilities.png"/>
 
-You can also edit the build.yml file directly with a text editor. Here is a list of capabilites you can add to the capabilities section in your application build.yml file.
+You can also edit the build.yml file directly with a text editor. Here is a list of capabilities you can add to the capabilities section in your application build.yml file.
 
 	audio
   	camera
@@ -362,6 +364,13 @@ You can set a greater minimal API level in build.yml. For example, the following
    android:
      minSDK: 11
 
+### Customizing application's AndroidManifest.xml
+
+If you have an urgent need to put changes in AndroidManifest.xml that are not supported by build settings, you may edit a manifest template located at <Rhodes>/platform/android/Rhodes/AndroidManifest.xml.erb.
+Please note that this template does not relate to a particular application: it is used for every Android application build.
+
+** NOTE: To see how to change AndroidManifest.xml at extension build, see [Extending the Rhodes Framework](extensions#rewriting-the-generated-native-extension-source-code-for-android). **
+
 ### Building and Running Your Android Application with RhoStudio
 
 To start the build process, create a Run Configuration: select your project in the Project Explorer, and either:
@@ -392,7 +401,7 @@ In the Run Configurations window, select Android in Platform, and Device in Simu
 
 #### Reading the Log File with RhoStudio
 
-After you run your applciation in RhoStudio, your application log file, rholog.txt, is stored in your application directory. You can open and read rholog.txt in RhoStudio by double-clicking on it in the Project Explorer.
+After you run your application in RhoStudio, your application log file, rholog.txt, is stored in your application directory. You can open and read rholog.txt in RhoStudio by double-clicking on it in the Project Explorer.
 
 ### Building and Running Your Android Application from the Command Line
 
@@ -516,7 +525,7 @@ Now you are ready to install your application on your device and/or emulator.
 
 In case of troubles in Eclipse while setting up the Android SDK and target, try "Rhodes project context menu" > "Android Tools" > "Fix Project Properties".
 
-It is possible your application has stopped unexpectedly just after the first build. In this case try to copy autogenerated java source files from the application folder <app>/bin/tmp to the Rhodes project.
+It is possible your application has stopped unexpectedly just after the first build. In this case try to copy auto-generated java source files from the application folder <app>/bin/tmp to the Rhodes project.
 
 ### Getting application log from device or emulator
 
@@ -563,7 +572,7 @@ Before you build edit build.yml from the application directory. Set the bbver to
 	bbver: 5.0
 
 #### To build and run using Blackberry simulator 5.0 and higher
-Starting from  Blackberry JDE 5.0, simulator supports loading application cod-files to simulator without restart. This feature greatly improve Blackberry development perfomance.
+Starting from  Blackberry JDE 5.0, simulator supports loading application cod-files to simulator without restart. This feature greatly improve Blackberry development performance.
 There are 2 possible scenarios available:
 
 * Load application cod-file manually using Simulator menu: 'File\Load Blackberry application or theme...':
@@ -723,7 +732,7 @@ The log.txt file is the extracted log and should appear on the `C:\` drive.
 	
 * Run eclipse and choose rhodes\platform\bb as a workspace directory. Do not create workspace!
 * Open menu Window\Preferences
-    * Blackberry java plug-in\Warnings - check all 3 chekboxes to suppress all warnings
+    * Blackberry java plug-in\Warnings - check all 3 checkboxes to suppress all warnings
     * Java\Compiler - set Compiler compliance level to 1.4
 * Go to File\Import... menu. Select `General\Existing projects into Workspace` workspace node. Press Next. 
     * Browse for `<rhodes>\platform\bb\RubyVM`. Press Finish. The project will be automatically build.
@@ -792,7 +801,7 @@ You can find installation files in QT SDK folder like below:
         For Symbian 9.4
 
         QT - C:/QtSDK/Symbian/sis/Symbian1/Qt/4.7.3/qt.sis
-        (install it only on disc C:, before install pls close all opened applications)
+        (install it only on disc C:, before install please close all open applications)
 
         QT WebKit - C:/QtSDK/Symbian/sis/Symbian1/Qt/4.7.3/qtwebkit.sis
         QT Mobility - C:/QtSDK/Symbian/sis/Symbian1/QtMobility/1.1.3/qtmobility.sis
@@ -817,7 +826,7 @@ NOTE: You have to install Rhodes on the same local disk with QtSDK!
 
 ### Build application from the command line
 
-Add pathes to Qt SDK and MS Visual Studio 2005 to rhobuild.yml in the Rhodes folder:
+Add paths to Qt SDK and MS Visual Studio 2005 to rhobuild.yml in the Rhodes folder:
 
         env:
           paths:
@@ -859,7 +868,9 @@ Follow [All Platforms Prerequisites](#all-platforms-prerequisites).
 Make sure you have installed the following software.
 
 * .NET Compact Framework
-* Windows Mobile 6 Professional SDK(s) 
+* For Windows Mobile 6: Windows Mobile 6 Professional SDK Refresh
+* For Windows Mobile 6.5.3: Windows Mobile 6.5.3 Professional DTK
+* For Windows CE 5.0: MC3000c50b PSDK from [Motorola Support Central](http://support.symbol.com/support/supportcentral/supportcentral.do?id=m1)
 * Microsoft Active Sync 4.5 for Windows XP; Windows Mobile Device Center for Windows Vista or higher
 * Microsoft Device Emulator 3.0 for Windows Vista or higher
 * Visual Studio 2008. 
@@ -937,6 +948,8 @@ To start the build process, create a Run Configuration: select your project in t
 
 The Run Configurations window appears.
 
+**NOTE: In the RhoStudio Run Configurations window, when you choose the Windows Mobile platform and any of the platform types (such as 6.0, 6.5.3, CE5.0), this platform setting overrides the SDK settings for Windows Mobile in the application build.yml file. This override does NOT affect RhoMobile Production Build, or using rake (without RhoStudio) to build and run a Windows Mobile app; these options use the Windows Mobile SDK settings in the build.yml file.**
+
 #### Running on the Windows Mobile Simulator in RhoStudio
 
 To run on the Windows Mobile simulator, select Windows Mobile in Platform and Simulator in Simulator type. Then click the Run button.
@@ -1052,9 +1065,24 @@ NOTE: If your application uses HTTPS protocol, then you need to build Qt librari
 
 ### Build application from the command line
 
-Make sure that path to vcbuild.exe (something like `C:\Program Files\Microsoft Visual Studio 9.0\VC\vcpackages`) is in your PATH env variable. The list of paths which should be in PATH env variable:
+Make sure that path to vcbuild.exe (something like `C:\Program Files\Microsoft Visual Studio 9.0\VC\vcpackages`) is in your PATH env variable. 
+
+The list of paths which should be in PATH env variable:
+<i>C:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE;C:\Program Files\Microsoft Visual Studio 9.0\VC\BIN;C:\Program Files\Microsoft Visual Studio 9.0\Common7\Tools;C:\Program Files\Microsoft Visual Studio 9.0\Common7\Tools\bin;C:\Program Files\Microsoft Visual Studio 9.0\VC\PlatformSDK\bin;C:\Program Files\Microsoft Visual Studio 9.0\SDK\v3.5\bin</i>
+
+Also check that the vcbuild path is shown in the rhobuild.yml file. The rhobuild.yml file is located in the Rhodes folder (example location: `C:/RhoStudio/ruby/lib/ruby/gems/1.8/gems/rhodes-3.1.1`).
+
+If you use Visual Studio 2008 :
+
+	env:
+	  paths:
+	    vcbuild: C:/Program Files/Microsoft Visual Studio 9.0/VC/vcpackages/vcbuild.exe
+
+If you use Visual Studio 2008 on 64-bit installations:
 
-<i>C:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE;C:\Program Files\Microsoft Visual Studio 9.0\VC\BIN;C:\Program Files\Microsoft Visual Studio 9.0\Common7\Tools;C:\Program Files\Microsoft Visual Studio 9.0\Common7\Tools\bin;C:\Program Files\Microsoft Visual Studio 9.0\VC\PlatformSDK\bin;C:\Program Files\Microsoft Visual Studio 9.0\SDK\v2.0\bin</i>
+	env:
+	  paths:
+	    vcbuild: C:/Program Files (x86)/Microsoft Visual Studio 9.0/VC/vcpackages/vcbuild.exe
 
 If you use Visual Studio 2010 : add path to `msbuild` to `rhobuild.yml` in rhodes folder:
 
@@ -1067,7 +1095,7 @@ To build and run the application issue command:
 	:::term
 	$ rake run:win32
 
-*NOTE: If you use HTTPS, add to the `PATH` variable: `<path-to-rhodes>\lib\extensions\openssl.so\ext\win32\bin`
+*NOTE: To use `rake run:win32` command, add to the `PATH` variable: `<path-to-rhodes>\lib\extensions\openssl.so\ext\win32\bin`
 
 To clean all temporary and binary files execute command:
 
@@ -1097,7 +1125,7 @@ On 64-bit platform:
 * Application Readme file can be provided by application developer. If file with README.html name exists in the root of application folder when Installer will display show readme at the final page of the Installer
 * Application Icon should be used for Installer and application exe
 
-To build intaller bundle use command:
+To build installer bundle use command:
 
 	:::term
 	$ rake device:win32:production 
@@ -1251,7 +1279,10 @@ In the build.yml in your application folder there is an entry "name". This is th
 	name: My Own App
 
 ### Application Icon
-Place your image to use as an icon in a folder called `icon` in your application. If you created an app called `testapp` then the folder would be `testapp/icon`. The icon should be named `icon.png` and  `icon.ico` for Windows Mobile. Starting from iOS 4.0, Apple require three icons for application: 57x57, 72x72 and 114x114 pixels. Prepare such files, name them as `icon57.png`, `icon72.png` and `icon114.png` and place into `icon` folder
+Place your image to use as an icon into the folder called `icon` in your application. If you created an app called `testapp` then the folder would be `testapp/icon`. 
+
+* Windows Mobile and Windows: You can add an icon in two formats: `icon.png` and  `icon.ico`. 
+* iOS 4.0: Apple require three icons for application: 57x57, 72x72 and 114x114 pixels. Prepare such files, name them as `icon57.png`, `icon72.png` and `icon114.png` and place into `icon` folder
 
 	testapp/
 		build.yml
@@ -1270,40 +1301,47 @@ Place your image to use as an icon in a folder called `icon` in your application
 * rhodes\platform\iphone\icon.png, icon57.png, icon72.png, icon114.png - change to your icons
 * check rhodes\platform\iphone\Info.plist it should contain BundleName=${PRODUCT_NAME}
 
+### Android
+You can change the icon for your Android application by replacing icon.png, which is in your application icon folder, with a new icon.png.
+
 ### Windows Mobile
-Windows Mobile Shell program caches program icons. This cache is cleared only when device or simulator is restarted.
-So if you change icon of application, you have to restart device/simulator(uninstall/install is not enough).
+Windows Mobile Shell program caches program icons. This cache is cleared only when the device or the simulator is restarted. If you change the icon of your application, you have to restart the device or simulator: uninstall/install is not enough.
 
 ### Symbian
-You can change icon for your Symbian application replacing icon.svg which is in your application icon folder with a new one.
+You can change the icon for your Symbian application by replacing icon.svg, which is in your application icon folder, with a new icon.svg.
+
+## Upgrade Application
+
+Rhodes 3.3 supports application code upgrade for iPhone (non AppStore distribution), Android, and Windows Mobile. You can do a total upgrade or partial upgrade.
+
+### Total Upgrade
 
-## Upgrade application
-Rhodes 3.3 support application code upgrade for iPhone(non AppStore distribution), Android and Windows Mobile.
+You can replace the total application bundle with a new bundle packed in an update bundle archive file.
 
-### Prepare application package
+#### Prepare Total Application Package
 
-To prepare upgrade package for iPhone run in application folder:
+To prepare the upgrade package for iPhone, run this command in your application folder:
 
 	:::term
     $ rake build:iphone:upgrade_package
 
-Application package will be placed to <app_root>/bin/target/iphone
+The application package will be placed in `<app_root>/bin/target/iphone`.
 
-To prepare upgrade package for Android run in application folder:
+To prepare the upgrade package for Android, run this command in your application folder:
 
 	:::term
     $ rake build:android:upgrade_package
     
-Application package will be placed to <app_root>/bin/target/android
+The application package will be placed in `<app_root>/bin/target/android`.
 
-To prepare upgrade package for Windows Mobile run in application folder:
+To prepare the upgrade package for Windows Mobile, run this command in your application folder:
 
 	:::term
     $ rake build:wm:upgrade_package
     
-Application package will be placed to <app_root>/bin/target/wmp6
+The application package will be placed in `<app_root>/bin/target/wmp6`.
 
-### Upgrade package from running application
+#### Download Bundle Package and Replace Application Current Bundle
 
 Download package:
     :::ruby
@@ -1322,13 +1360,84 @@ Unzip and replace package:
         WebView.navigate url_for :action => :error    
     end
 
-Application will restart automatically.
+The application will restart automatically.
 
-NOTE: On iPhone and Android application has to be started manually.
+NOTE: On iPhone and Android, the application has to be started manually.
 
-NOTE: When using Rho::RhoSupport.rhobundle_download method on a network that has proxies, you may need to configure a proxy exception on the device, if your  HTTP server is also on that same network. Ex: local network has an IP subnet of 192.168 and it uses a proxy. On the Windows Mobile device go into System >> Settings >> Connections >>Advanced and add 192.168.* to the proxy exception list. 
+NOTE: When using Rho::RhoSupport.rhobundle_download method on a network that has proxies, you may need to configure a proxy exception on the device, if your  HTTP server is also on that same network. Example: local network has an IP subnet of 192.168 and it uses a proxy. On the Windows Mobile device, go into System >> Settings >> Connections >> Advanced and add 192.168.* to the proxy exception list. 
+
+NOTE: The URL parameter for rhobundle_download must be a HTTP URL - FTP is not supported.
+
+### Partial Upgrade
+
+You can add new files or replace old files with new ones and create an updated bundle packed in an update bundle archive file.
+
+#### Prepare Partial Application Package
+
+To add new files or replace old files with new ones in your current application's bundle content, make a list of the files in a file named `upgrade_package_add_files.txt`. Here is an example of upgrade_package_add_files.txt.
+
+	app/index.erb
+	app/Bundle/controller.rb
+	app/Bundle/error.erb
+
+In the same way, you can also remove files with an `upgrade_package_remove_files.txt` file. Here is an example of upgrade_package_remove_files.txt.
+
+	app/Bundle/wait.erb
+	app/Model2
+
+Execute the rake commands in your application folder to perform the partial upgrade.
+
+To prepare partial upgrade package for iPhone run in application folder:
+
+	:::term
+	$ rake build:iphone:upgrade_package_partial
+
+Application package will be placed to /bin/target/iphone
+
+To prepare partial upgrade package for Android run in application folder:
+
+	:::term
+	$ rake build:android:upgrade_package_partial
+
+Application package will be placed to /bin/target/android
+
+To prepare partial upgrade package for Windows Mobile run in application folder:
+
+	:::term
+	$ rake build:wm:upgrade_package_partial
+
+Application package will be placed to /bin/target/wmp6.
+
+#### Download Bundle Package and Replace Application Current Bundle
+
+You then unzip, upload and replace the application package. 
+
+Download package:
+    :::ruby
+    if !::Rho::RhoSupport.rhobundle_download(url_to_package, url_for(:action => :httpdownload_callback))
+        render :action =>:error    
+    else
+        render :action => :wait_download, :back => '/app'
+    end   
+
+Upload and Replace Package:
+	:::ruby
+	if System.unzip_file(::Rho::RhoSupport.rhobundle_getfilename())==0
+	   System.replace_current_bundle( File.dirname(::Rho::RhoSupport.rhobundle_getfilename()),  { :callback => url_for(:action => :update_finished_callback), :do_not_restart_app => true } )
+	   render :action => :wait_replace, :back => '/app'
+	else
+	   WebView.navigate url_for :action => :error    
+	end
+
+With the System.replace_current_bundle method, you can supply a params hash with the following options.
+
+`:callback` - url with callback. Called when upgrade bundle procedure is finished.
+`:do_not_restart_app` - bool, if true your application will not automatically restart after the procedure is finished.
+
+One of the callback parameters should be `status`: `"ok"` or `"error"`.
+
+NOTE: Use :do_not_restart_app very carefully. You can disable the restart of your application after a bundle update only if you change only images, JavaScript, and other similar types of files, but if you change files such as Ruby code, models, etc. In general, we recommend you do not use this parameter if you do not understand how your application works on your particular platform. Restarting your application after an update is safe.
+
+### Sample Upgrade Bundle Package
 
-NOTE: The URL parameter for rhobundle_download must be a HTTP URL - FTP is not supported
-    
-### Sample
 See [Reload bundle demo](http://github.com/rhomobile/ReloadBundleDemo) for more information.