rhodes 3.3.5 → 3.4.2

data/CHANGELOG

@@ -2,7 +2,9 @@
 * Support freezed models (FixedSchema and PropertyBag)
 * Detect available network types
 * iPhone: support Xcode 4.3
-* Fix Windows Mobile issues
+* Support JQueryMobile on Windows Phone 7
+* Fix several RhoConnect Client issues
+* The following features become part of RhoElements v2: database encryption, Windows Mobile and Windows CE support, Barcode, NFC and Inline Signature Capture
 
 ## 3.3.2
 * iPhone: fix AppStore sumbit issue. Now all files stored in Private Documents, only database and user files in Documents 

data/CREDITS

@@ -2251,3 +2251,8 @@ Rhodes contains code from the following other projects:
  pdf-writer (http://ruby-pdf.rubyforge.org/pdf-writer/index.html)
  License: MIT-Style (http://ruby-pdf.rubyforge.org/pdf-writer/licence.html)
  
+ OpenSSL (http://www.openssl.org) based on SSLeay library (license of OpenSSL contains both licenses - see link below)
+ License: BSD-style (http://www.openssl.org/source/license.html)
+ 
+ EzCrypto (http://ezcrypto.rubyforge.org/)
+ License: MIT (http://ezcrypto.rubyforge.org/)

data/Rakefile

@@ -37,7 +37,21 @@ module Rake
   end
 end
 
+# Restore process error mode on Windows.
+# Error mode controls wether system error message boxes will be shown to user.
+# Java disables message boxes and we enable them back.
+#if RUBY_PLATFORM =~ /(win|w)32$/
+#  require 'win32/process'
+#  class WindowsError
+#    include Windows::Error
+#  end
+#  WindowsError.new.SetErrorMode(0)
+#end
+
 $app_basedir = pwd
+$startdir = File.dirname(__FILE__)
+$startdir.gsub!('\\', '/')
+
 chdir File.dirname(__FILE__)
 
 require File.join(pwd, 'lib/build/jake.rb')
@@ -90,6 +104,9 @@ def make_application_build_config_header_file
   f.puts "#include <string.h>"
   f.puts ""
   f.puts '#include "app_build_configs.h"'
+  if $rhosimulator_build
+    f.puts '#include "common/RhoSimConf.h"'
+  end
   f.puts ""
       
   f.puts 'static const char* keys[] = { ""'
@@ -103,7 +120,7 @@ def make_application_build_config_header_file
 
   f.puts 'static const char* values[] = { ""'
   $application_build_configs.keys.each do |key|
-    f.puts ',"'+$application_build_configs[key].to_s+'"'
+    f.puts ',"'+$application_build_configs[key].to_s().gsub('\\', "\\\\\\")+'"'
     count = count + 1
   end
   f.puts '};'
@@ -113,6 +130,11 @@ def make_application_build_config_header_file
   f.puts ''
   f.puts 'const char* get_app_build_config_item(const char* key) {'
   f.puts '  int i;'
+  if $rhosimulator_build
+    f.puts '  if (strcmp(key, "security_token") == 0) {'
+    f.puts '    return rho_simconf_getString("security_token");'
+    f.puts '  }'
+  end
   f.puts '  for (i = 1; i < APP_BUILD_CONFIG_COUNT; i++) {'
   f.puts '    if (strcmp(key, keys[i]) == 0) {'
   f.puts '      return values[i];'
@@ -123,6 +145,7 @@ def make_application_build_config_header_file
   f.puts ''
   
   Jake.modify_file_if_content_changed(File.join($startdir, "platform", "shared", "common", "app_build_configs.c"), f)
+  
 end
 
 def make_application_build_capabilities_header_file
@@ -192,10 +215,47 @@ def make_application_build_config_java_file
     Jake.modify_file_if_content_changed( File.join( $startdir, "platform/bb/RubyVM/src/com/rho/AppBuildConfig.java" ), f )
 end
 
+def update_rhoprofiler_java_file
+    use_profiler = $app_config['profiler'] || ($app_config[$current_platform] && $app_config[$current_platform]['profiler'])
+    
+    content = ""
+    File.open( File.join( $startdir, "platform/bb/RubyVM/src/com/rho/RhoProfiler.java" ), 'rb' ){ |f| content = f.read() }
+    is_find = nil
+
+    if use_profiler
+        is_find = content.sub!( 'RHO_STRIP_PROFILER = true;', 'RHO_STRIP_PROFILER = false;' )
+    else
+        is_find = content.sub!( 'RHO_STRIP_PROFILER = false;', 'RHO_STRIP_PROFILER = true;' )
+    end    
+    
+    if is_find
+        puts "RhoProfiler.java has been modified: RhoProfiler is " + (use_profiler ? "enabled!" : "disabled!")
+        File.open( File.join( $startdir, "platform/bb/RubyVM/src/com/rho/RhoProfiler.java" ), 'wb' ){ |f| f.write(content) }
+    end
+
+end
+
+def update_rhodefs_header_file
+    use_profiler = $app_config['profiler'] || ($app_config[$current_platform] && $app_config[$current_platform]['profiler'])
+    
+    content = ""
+    File.open( File.join( $startdir, "platform/shared/common/RhoDefs.h" ), 'rb' ){ |f| content = f.read() }
+    is_find = nil
+
+    if use_profiler
+        is_find = content.sub!( '#define RHO_STRIP_PROFILER 1', '#define RHO_STRIP_PROFILER 0' )
+    else
+        is_find = content.sub!( '#define RHO_STRIP_PROFILER 0', '#define RHO_STRIP_PROFILER 1' )
+    end    
+    
+    if is_find
+        puts "RhoDefs.h has been modified: RhoProfiler is " + (use_profiler ? "enabled!" : "disabled!")
+        File.open( File.join( $startdir, "platform/shared/common/RhoDefs.h" ), 'wb' ){ |f| f.write(content) }
+    end
+end
+
 namespace "config" do
   task :common do
-    $startdir = File.dirname(__FILE__)
-    $startdir.gsub!('\\', '/')
     
     $binextensions = []
     buildyml = 'rhobuild.yml'
@@ -215,7 +275,7 @@ namespace "config" do
         $rubypath = "res/build-tools/rubylinux"
       end
     end
-	
+
     if $app_path.nil? #if we are called from the rakefile directly, this wont be set
       #load the apps path and config
 
@@ -258,7 +318,8 @@ namespace "config" do
        $app_config["extensions"].is_a? Array
     extensions += $app_config[$config["platform"]]["extensions"] if $app_config[$config["platform"]] and
        $app_config[$config["platform"]]["extensions"] and $app_config[$config["platform"]]["extensions"].is_a? Array
-    $app_config["extensions"] = extensions
+    extensions += get_extensions
+    $app_config["extensions"] = extensions.uniq
     
     capabilities = []
     capabilities += $app_config["capabilities"] if $app_config["capabilities"] and
@@ -308,7 +369,7 @@ namespace "config" do
         
         if $app_config["extensions"].index("webkit-browser")
             $app_config["capabilities"] += ["webkit_browser"]
-            $app_config["extensions"].delete("webkit-browser") unless $current_platform == 'android'
+            $app_config["extensions"].delete("webkit-browser")
         end
         
         if  $app_config["capabilities"].index("webkit_browser") || $app_config["capabilities"].index("motorola")
@@ -347,6 +408,10 @@ namespace "config" do
     if $current_platform == "wm"
         $rhoelements_features += "- Windows Mobile/Windows CE platform support\n"
     end
+
+    if $current_platform == "win32" && !$is_rho_simulator
+        $rhoelements_features += "- Windows Desktop platform support\n"
+    end
     
     if $application_build_configs['encrypt_database'] && $application_build_configs['encrypt_database'].to_s == '1'
         #$application_build_configs.delete('encrypt_database')
@@ -360,6 +425,15 @@ namespace "config" do
     if $app_config['extensions'].index('webkit-browser')
         $rhoelements_features += "- Motorola WebKit Browser\n"                
     end
+
+    if File.exist?(File.join($app_path, "license.yml"))
+        license_config = Jake.config(File.open(File.join($app_path, "license.yml")))    
+    
+        if ( license_config )
+            $application_build_configs["motorola_license"] = license_config["motorola_license"] if license_config["motorola_license"]
+            $application_build_configs["motorola_license_company"] = license_config["motorola_license_company"] if license_config["motorola_license_company"]
+        end    
+    end    
     
     $invalid_license = false
 
@@ -397,6 +471,9 @@ namespace "config" do
         
     $app_config['extensions'].uniq!() if $app_config['extensions']
     $app_config['capabilities'].uniq!() if $app_config['capabilities']
+
+    $app_config['extensions'].delete("mspec") if !$debug && $app_config['extensions'].index('mspec')
+    $app_config['extensions'].delete("rhospec") if !$debug && $app_config['extensions'].index('rhospec')
     
     if $invalid_license
         $application_build_configs["motorola_license"] = '123' if !$application_build_configs["motorola_license"]
@@ -408,15 +485,22 @@ namespace "config" do
 
     
     if $current_platform == "bb"  
-      make_application_build_config_java_file
-    else  
+      make_application_build_config_java_file()
+      update_rhoprofiler_java_file()
+    elsif $current_platform == "wp"  
+    else
       make_application_build_config_header_file    
       make_application_build_capabilities_header_file
+      update_rhodefs_header_file
     end
 
     $rhologhostport = $config["log_host_port"] 
     $rhologhostport = 52363 unless $rhologhostport
-	$rhologhostaddr = Jake.localip()
+    begin
+	    $rhologhostaddr = Jake.localip()
+    rescue Exception => e      
+        puts "Jake.localip() error : #{e}"  
+    end
 
     $obfuscate_js = (($app_config["obfuscate"].nil? || $app_config["obfuscate"]["js"].nil?) ? nil : 1 )
     $obfuscate_css = (($app_config["obfuscate"].nil? || $app_config["obfuscate"]["css"].nil?) ? nil : 1 )
@@ -434,6 +518,10 @@ namespace "config" do
     $macdeployqt = File.join($qtdir, 'bin/macdeployqt')
   end
 
+  task :rhosimulator do
+    $rhosimulator_build = true
+  end
+
   out = `javac -version 2>&1`
   puts "\n\nYour java bin folder does not appear to be on your path.\nThis is required to use rhodes.\n\n" unless $? == 0
 end
@@ -574,6 +662,9 @@ def init_extensions(startdir, dest)
           if type.to_s() != "nativelib"
             libs = extconf["libraries"]
             libs = [] unless libs.is_a? Array
+            if (!extconf[$config["platform"]].nil?) && (extconf[$config["platform"]]["libraries"].is_a? Array)
+              libs = libs + extconf[$config["platform"]]["libraries"]
+            end
             if $config["platform"] == "wm" || $config["platform"] == "win32"
               libs.map! { |lib| lib + ".lib" }
             else
@@ -678,6 +769,42 @@ def public_folder_cp_r(src_dir,dst_dir,level,obfuscate)
   end
 end
 
+def copy_rhoconfig(source, target)
+  override = get_config_override_params
+  mentioned = Set.new
+
+  lines = []
+
+  # read file and edit overriden parameters
+  File.open(source, 'r') do |file|
+    while line = file.gets
+      match = line.match(/^(\s*)(\w+)(\s*=\s*)/)
+      if match
+        name = match[2]
+        if override.has_key?(name)
+          lines << "#{match[1]}#{name}#{match[3]}#{override[name]}"
+          mentioned << name
+          next
+        end
+      end
+      lines << line
+    end
+  end
+
+  # append rest of overriden parameters to text
+  override.each do |key, value|
+    if !mentioned.include?(key)
+      lines << ''
+      lines << "#{key} = #{value}"
+    end
+  end
+
+  # write text to target file
+  File.open(target, 'w') do |file|
+    lines.each { |l| file.puts l }
+  end
+end
+
 def common_bundle_start(startdir, dest)
   puts "common_bundle_start"
   
@@ -715,7 +842,7 @@ def common_bundle_start(startdir, dest)
       public_folder_cp_r app + '/public', File.join($srcdir,'apps/public'), 0, 1
     end
   end
-  cp app + '/rhoconfig.txt', File.join($srcdir,'apps'), :preserve => true
+  copy_rhoconfig(File.join(app, 'rhoconfig.txt'), File.join($srcdir, 'apps', 'rhoconfig.txt'))
 
   if $app_config["app_type"] == 'rhoelements'
     $config_xml = nil
@@ -732,13 +859,14 @@ def common_bundle_start(startdir, dest)
   end
 
   app_version = "\r\napp_version='#{$app_config["version"]}'"  
+  app_version += "\r\ntitle_text='#{$app_config["name"]}'"  if $current_platform == "win32"
+  
   File.open(File.join($srcdir,'apps/rhoconfig.txt'), "a"){ |f| f.write(app_version) }
   File.open(File.join($srcdir,'apps/rhoconfig.txt.timestamp'), "w"){ |f| f.write(Time.now.to_f().to_s()) }
   
   unless $debug
-    rm_rf $srcdir + "/apps/app/test"
     rm_rf $srcdir + "/apps/app/SpecRunner"
-    rm_rf $srcdir + "/apps/app/mspec"
+    rm_rf $srcdir + "/apps/app/spec"
     rm_rf $srcdir + "/apps/app/mspec.rb"
     rm_rf $srcdir + "/apps/app/spec_runner.rb"
   end
@@ -812,7 +940,23 @@ def process_exclude_folders
   end
 
 end
-  
+
+def get_config_override_params
+    override = {}
+    ENV.each do |key, value|
+        key.match(/^rho_override_(.+)$/) do |match|
+            override[match[1]] = value
+        end
+    end
+    return override
+end
+
+def get_extensions
+    value = ENV['rho_extensions']
+    return value.split(',') if value
+    return []
+end
+
 namespace "build" do
   namespace "bundle" do
     task :xruby do
@@ -1378,6 +1522,7 @@ namespace "run" do
         puts "rho_reload_app_changes : #{ENV['rho_reload_app_changes']}"
         $path = ""
         $args = ["-approot='#{$app_path}'", "-rhodespath='#{$startdir}'"]
+        $args << "-security_token=#{ENV['security_token']}" if !ENV['security_token'].nil?
         cmd = nil
 
         if RUBY_PLATFORM =~ /(win|w)32$/
@@ -1465,20 +1610,31 @@ namespace "run" do
                 end
             else
             
-                if $config["platform"] != "bb"
-                    extyml = File.join(extpath, "ext.yml")
-                    next if File.file? extyml
-                end
+                # if $config["platform"] != "bb"
+                #     extyml = File.join(extpath, "ext.yml")
+                #     next if File.file? extyml
+                # end
                 
                 config_ext_paths += "#{extpath};" if extpath && extpath.length() > 0                     
             end    
         end
 
         sim_conf += "ext_path=#{config_ext_paths}\r\n" if config_ext_paths && config_ext_paths.length() > 0 
+
+        security_token = $app_config["security_token"]
+        sim_conf += "security_token=#{security_token}\r\n" if !security_token.nil?
         
         fdir = File.join($app_path, 'rhosimulator')
         mkdir fdir unless File.exist?(fdir)
             
+        get_config_override_params.each do |key, value|
+            if key != 'start_path'
+                puts "Override '#{key}' is not supported."
+                next
+            end
+            sim_conf += "#{key}=#{value}\r\n"
+        end
+
         fname = File.join(fdir, 'rhosimconfig.txt')
         File.open(fname, "wb") do |fconf|
             fconf.write( sim_conf )

data/doc/build.txt

@@ -283,14 +283,17 @@ Check that your [OS is compatible with the Android SDK](http://developer.android
 
 Download the [Android SDK](http://developer.android.com/sdk/index.html), and unzip it to the location of your choice.
 
-On Macintosh and Linux, navigate to and run <Android SDK>/tools/android. On Windows, navigate to and run <Android SDK>/SDK Setup.exe. The Android SDK and AVD Manager window appears. Then perform the following steps:
+On Macintosh and Linux, navigate to and run `<Android SDK>/tools/android sdk`. On Windows, navigate to and run <Android SDK>/SDK Manager.exe. The Android SDK Manager window appears. Then perform the following steps:
 
  * Select Settings, then check "check `Force https://... sources to be fetched using http://".
- * Select Available packages, expand the Android repository and Third Party add-ons, check the Android SDK Platform(s) and Google APIs of your choice, then click the "Add Add-on site" button to download them.
- * Set up an AVD (Android Virtual Device) by clicking on Virtual Devices, and clicking the New button. More detailed instructions can be on the Google site for [Managing AVDs with AVD Manager](http://developer.android.com/guide/developing/devices/managing-avds.html).
+ * Run Android SDK Manager, check latest Android SDK Platform(s) and Google APIs, then click "Install packages" button to download and install them.
+
+** NOTE: To use Google Map View you need to install latest Google API from Android SDK Manager **
 
 Download and unzip the [Android NDK](http://developer.android.com/sdk/ndk/index.html) to the location of your choice.
 
+** 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.
 
 <img src="http://rhodocs.s3.amazonaws.com/rhostudio-tutorial/preferences-android-sdk.png"/>
@@ -899,14 +902,14 @@ Also check that the vcbuild path is shown in the rhobuild.yml file. The rhobuild
 
 	env:
 	  paths:
-	    vcbuild: C:/Program Files/Microsoft Visual Studio 9/VC/vcpackages/vcbuild.exe
+	    vcbuild: C:/Program Files/Microsoft Visual Studio 9.0/VC/vcpackages/vcbuild.exe
 	    cabwiz: C:/Program Files/Windows Mobile 6 SDK/Tools/CabWiz
 
 On 64-bit installations:
 
 	env:
 	  paths:
-	    vcbuild: C:/Program Files (x86)/Microsoft Visual Studio 9/VC/vcpackages/vcbuild.exe
+	    vcbuild: C:/Program Files (x86)/Microsoft Visual Studio 9.0/VC/vcpackages/vcbuild.exe
 	    cabwiz: C:/Program Files (x86)/Windows Mobile 6 SDK/Tools/CabWiz
 
 ### Setup target SDK and emulator
@@ -1014,7 +1017,7 @@ Run
 
 Make sure you cradle your emulator (menu Tools/Device Emulator Manager/Select Running Emulator/Actions/Cradle)
 
-Copy `rhodes.exe` and `rhobundle` (located at `<source-code-root>\platform\wm\bin\Win32\rhodes\Debug\rho`) created at the previous step to the device: `My Computer\Mobile Device` and folder in Program Files on that device (for example, `\Program Files\rhodes`). You can first delete the contents of `\Program Files\rhodes\rho` folder on your device if you want to ensure there are no old files left over.
+Copy `rhodes.exe` and `rhobundle` (located at `<source-code-root>\platform\wm\bin\win32\rhodes\Debug\rho`) created at the previous step to the device: `My Computer\Mobile Device` and folder in Program Files on that device (for example, `\Program Files\rhodes`). You can first delete the contents of `\Program Files\rhodes\rho` folder on your device if you want to ensure there are no old files left over.
 
 If you changed your application, then recompile your application code by running the following command again, and copying `rhobundle` and `rhodes.exe` again:
 
@@ -1041,15 +1044,17 @@ To read the log file from the emulator or your device:
 
 * Follow [All Platforms Prerequisites](#all-platforms-prerequisites)
 * Visual Studio 2008
-* WTL : http://wtl.sourceforge.net/ :
-	* unzip to folder: <VS path>\VC\WTL
-	* open in Visual studio menu `Tools\Options\Projects and solutions\VC++ directories`. Select platform - `Win32`; Show directories for - `Include files`; Add - `$(VCInstallDir)wtl\include`
+* Install [Qt libraries 4.7.4 for Visual Studio 2008](http://download.qt.nokia.com/qt/source/qt-win-opensource-4.7.4-vs2008.exe) (235 MB)
+* Create new (or update existing) system environment variable `QTDIR` and make sure it points to root folder of the installed Qt libraries, e.g. `C:\Qt\4.7.4`
+* Add `bin` folder of installed Qt libraries, e.g. `C:\Qt\4.7.4\bin`, to `PATH` system environment variable
+
+NOTE: If your application uses HTTPS protocol, then you need to build Qt libraries with OpenSSL (see <a href="#build-for-windows-https">instructions below</a>).
 
 ### Build application from the command line
 
-Make sure that path to vcbuild.exe (something like `C:\Program Files\Microsoft Visual Studio 9\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\Common7\IDE;C:\Program Files\Microsoft Visual Studio 9\VC\BIN;C:\Program Files\Microsoft Visual Studio 9\Common7\Tools;C:\Program Files\Microsoft Visual Studio 9\Common7\Tools\bin;C:\Program Files\Microsoft Visual Studio 9\VC\PlatformSDK\bin;C:\Program Files\Microsoft Visual Studio 9\SDK\v2.0\bin</i>
+<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>
 
 If you use Visual Studio 2010 : add path to `msbuild` to `rhobuild.yml` in rhodes folder:
 
@@ -1057,46 +1062,85 @@ If you use Visual Studio 2010 : add path to `msbuild` to `rhobuild.yml` in rhode
 	  paths:
 	    vcbuild: msbuild
 
-To build and run emulator run:
+To build and run the application issue command:
 
 	:::term
-	$rake  run:win32
+	$ rake run:win32
+
+*NOTE: If you use HTTPS, add to the `PATH` variable: `<path-to-rhodes>\lib\extensions\openssl.so\ext\win32\bin`
 
-To clean all binaries run:
+To clean all temporary and binary files execute command:
 
 	:::term
-	$rake clean:win32
+	$ rake clean:win32
 
-### Create application installer for windows platform
+### Create application installer for Windows
 
-Download NSIS installer tool (http://nsis.sourceforge.net/Download) 
+Download [NSIS installer tool](http://nsis.sourceforge.net/Download).
 
-Add path to NSIS complier path to 'rhobuild.yml' in rhodes folder:
+Add path to NSIS complier to 'rhobuild.yml' in rhodes folder:
 
 On 32-bit platform:
 
-        env:
-          paths:
-            nsis: C:/Program Files/NSIS/makensis.exe
+    env:
+      paths:
+        nsis: C:/Program Files/NSIS/makensis.exe
 
 On 64-bit platform:
 
-        env:
-          paths:
-            nsis: C:/Program Files (x86)/NSIS/makensis.exe
+    env:
+      paths:
+        nsis: C:/Program Files (x86)/NSIS/makensis.exe
 
+#### Readme, license and icon
+* Application License can be provided by application developer. If file with LICENSE.txt name exists in the root of application folder when Installer will display separate page to confirm the license.
+* 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 run:
+To build intaller bundle use command:
 
 	:::term
-	$rake run:win32:production 
+	$ rake device:win32:production 
 
-and after finished build process you can find installer for you application in bin subfolder with 'RhodesBundle.exe' name 
+After the build process is finished you can find the installer bundle named `<application-name>-setup.exe` in `<application-root>/bin/target/win32` folder.
 
 ### Logging
 
 Rholog.txt is placed in `<rhodes folder>\platform\wm\bin\win32\rhodes\Debug\rho`
 
+### <a name="build-for-windows-https"></a>How to enable HTTPS protocol
+
+If your application needs HTTPS, then you need to build the Qt libraries for Visual Studio 2008 with OpenSSL as described below:
+
+* Download the [Qt 4.7.4 source](http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.7.4.zip) (237 MB) and extract the archive, e.g. into `C:\Qt\4.7.4-src`
+* Open Control Panel » System » Advanced system settings » Environment Variables and then:
+    * Create new (or update existing) system variable `QTDIR` = `C:\Qt\4.7.4` (this will be the installation folder for the compiled Qt libraries)
+    * Add to the `PATH` variable: `C:\Qt\4.7.4\bin` (it doesn't matter that this folder does not exist yet)
+    * To make command 'rake run:win32' work - Add to the `PATH` variable: `<path-to-rhodes>\lib\extensions\openssl.so\ext\win32\bin`
+    * 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 Qt library run in the same command prompt:
+
+		> cd \Qt\4.7.4-src
+		> configure -opensource -platform win32-msvc2008
+		  -nomake examples -nomake demos -nomake docs
+		  -qt-libpng -qt-libjpeg -qt-libtiff -qt-libmng -qt-gif
+		  -openssl-linked -no-qt3support -prefix C:/Qt/4.7.4
+		  -I <path-to-rhodes>/lib/extensions/openssl.so/ext/win32/include
+		  -L <path-to-rhodes>/lib/extensions/openssl.so/ext/win32/lib
+		> nmake
+		> nmake install
+		> 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
+
+Now when you build your application the usual way, the HTTPS protocol support will be enabled automatically.
+
 ## Build for Windows Phone 7
 
 ### Prerequisites