Re-branding and Building Protocol App from Source Code

The functionality described in this article is introduced in IT Hit Ajax File Browser v4 Beta.

The IT Hit Ajax File Browser Source Codes License is provided with complete Protocol Applications source codes. You can fully re-brand, localize and customize the protocol applications for Windows, OS X and Linux. The source codes are provided with build scripts that you can use to compile and build installers for each OS "in one click".

With Source Codes License you can:

  • Update the application name, version, company name, e-mail and URL of the company website.
  • Update the web browser protocol name.
  • Update all texts and graphics that appear in protocol applications.
  • Fully customize the installers, change any texts and graphics.
  • Sign the installer with your own code signing certificate(s).
  • Create your customized builds and run them side-by-side on one machine without interfering with each other and with IT Hit WebDAV Ajax Library Protocol Applications.

Download the Source Codes

To download the source codes login with the e-mail address that was specified during the Source Codes License purchase and download the archive in the product download area.

Before You Build

Make Your App to Run Side-By-Side with IT Hit Protocol Apps

To make sure your application can run side-by-side with IT Hit Edit Document Opener you must edit the Settings.xml file and specify application name, protocol name and OS X application identifier that are different from the one specified in Settings.xml by default.

Important! Changing the application name, protocol name and OS X application identifier in Settings.xml are critical for running your app side-by-side and not interfering with IT Hit's version. As soon as these settings are unique you can safely install and uninstall several custom builds on one machine as well as install/uninstall them with IT Hit's version.

Install Build Prerequisites

Build requirements for each platform are specified in the Readme file located in \Source\Plugins\<OS>\Build\ folder. Follow the instructions and install all required software on your build machine.

Obtain Code Signing Certificates (Optional)

The code signing certificates are NOT provided with the source codes. While you can build the application without signing, we recommend to obtain your own code signing certificates so users clearly understand the origin of the software. Place the code signing certificates in the folder specified in the build requirements for each OS.

Building

To build the application run the batch file located in the \Source\Plugins\<OS>\Build\ folder.

  • On Windows run: build.bat
  • On OS X run: ./build.sh
  • On Linux run: python build.py

This will compile all components, create an installer(s) and sign them (in case the code signing certificate(s) are present). The installer file(s) will be created in the \Source\Plugins\<OS>\Build\ folder.

 

Next Article:

Troubleshooting Edit Document Opener Protocol Application Issues