Walkthrough for your first time using wyBuild

Learn how to use wyBuild, add the updater (wyUpdate) to your app, and how to test your first update. You should at the very least give the video tutorial a look.

Step 1: Get wyBuild

The first thing you need to do is download and install wyBuild. The wyBuild installer contains everything you need to add updating to your application.

Step 2: Start wyBuild & Create a new project

wyBuild iconAfter downloading and installing wyBuild you'll have the purple wyBuild icon on your desktop. Double click it and create a new project.


Step 3: Building wyUpdate

A. Enter your Product & Company names

Simply enter your product and company names in the textboxes.

Enter your Product & Company names

B. Choose the wyUpdate branding

You can choose from one of the pre-made themes, or you can create your own:

Choose your wyUpdate theme

C. Select languages & translate wyUpdate

You can include multiple translations of wyUpdate. Either choose from one of the included translations, or create your own translation.

Translate wyUpdate

D. Set the version you'll be including wyUpdate with

wyBuild doesn't need to know about all your earlier versions. Just start with the current version you'll be releasing to your users, and enter that in the version textbox in wyBuild:

First version of your app

You don't need to enter changes for this version, since no one will be updating to this version.

E. Sites where the updates will be downloaded from

Now we'll set where wyUpdate will download updates from:

Download sites

You should specify the site in the form of [protocol]://[sitename]/sub/directories/%file%. For example: https://yoursite.com/updates/%file%.

wyUpdate can download from any of the following protocols:

Note: for FTP sites you need to url-encode special characters.

F. Build wyUpdate

Now we're ready to build wyUpdate for inclusion with version 1.1 of your app. Click the "Build wyUpdate" button:

Build wyUpdate

G. Build blank update & upload it

As you may have noticed earlier, we haven't added any files to your project. That's alright. For the first version of your product that includes wyUpdate you'll just be building a blank update. That way when wyUpdate checks with your servers it knows that it's up-to-date.

To build the blank update simply click the "Build Updates" button:

Build blank updates

Upload the blank update you just built. You can add any FTP, SFTP (aka SSH FTP), Amazon S3, or Windows Network Share sites directly within wyBuild. After you've added the sites you'll be uploading your updates to, click "Upload updates".

Upload the updates

If your server isn't capable of accepting FTP, SFTP, Amazon S3, or Windows Network Share uploads, you can use any 3rd party uploader program (e.g. Cyberduck) to upload your updates. Just upload all files in the "Updates" folder after you click "Build updates".

H. Test wyUpdate

Now run wyUpdate. It should say you have the latest version installed.

Latest version of your app installed

Get a 404 error? If so, make sure the site you typed in step 3E is correct. If you're using Microsoft's IIS server, make sure you set the MIME types of the .wys and .wyu file types to "application/octet-stream". Read how to configure your server (with pictures).

Step 4: Integrating the updater with your app

To add updating ability to your app all you have to do is add the wyUpdate.exe and client.wyc files with your application. Of course, you can more deeply integrate wyUpdate in your app.

.NET Apps: Use the AutomaticUpdater

If you're making a .NET app and you want full control over every step of the updating process then use the AutomaticUpdater.

After adding the AutomaticUpdater to your app, try checking for updates within your app. It should say you're all up to date:

Latest update already installed

Non-.NET Apps: Silent checking & updating

If you're not making a .NET app, you can still add silent checking and silent updating to any application no matter the language (C, C++, VB6, Delphi, Java, etc.):

Step 5: Build your installer

While wyBuild doesn't currently build installers for you, there are many good free alternatives (NSIS, Inno Setup, WiX, etc.). When you're building your installer include all of your app files and folders along with "wyUpdate.exe" and "client.wyc".

Including files with your installer

Step 5b: Disable advertised shortcuts (For MSI installers)

If you're making an MSI installer then you will need to disable "Advertised shortcuts" or you will run into problems where the MSI installer tries to "repair" your updated app. If you're not making an MSI installer you can skip this step.

In WiX you can disable advertised shortcuts by setting the Advertise="no" attribute for every <Shortcut> element. For the Visual Studio installer maker (and other 3rd part MSI makers) this involves setting DISABLEADVTSHORTCUTS=1. See:

Step 6: First update

Add your first version files

Version foldersIf you haven't already done so, you'll need to add the files for your first version of your app to wyBuild. wyBuild only references files from disk — it does not store your files for you, which means this involves 3 steps:

  1. Create a folder to store the files for this first version that includes wyUpdate (in this example we call it version 1.1).

  2. Copy all of the files from version 1.1 of your app into this folder.

  3. Drag all the files into wyBuild from inside this "1.1" folder you just copied.

Note: There are several different target folders within wyBuild. The one most people will use is the "Your program's folder". This folder corresponds to the folder where the "wyUpdate.exe" and "client.wyc" files are sitting on your customer's computer (i.e. in your app's base directory). This way you don't need to hard code your application paths.


Add your new version files

Now that you've added the first version of your app into wyBuild we need to do the similar process for the next version (let's call it version 1.2):

  1. Create a folder to store the files for this new version (we're calling it 1.2).

  2. Copy all of the files from version 1.2 of your app into this folder.

  3. Click the "new version" tab in wyBuild:
    Adding a new version in wyBuild

  4. Drag all the files into wyBuild from inside this "1.2" folder you just copied.

Re-build wyUpdate

We're going to re-build wyUpdate. As you'll notice this re-built version will be for inclusion with version 1.2 of your app (as opposed to before, when you built wyUpdate for version 1.1 of your app).

Build wyUpdate

Build your updates

In the steps above you added all the files from two version of your app (we're calling them 1.1 and 1.2). Now when you click "Build update" button, wyBuild will dynamically scan the files on disk and generate small patches for you.

Build your new updates

Upload the updates to your server

Click the "Upload updates" button to upload your newly created update files. Now your users will be able to update to the new version of your app.

Upload the updates

(Optional) Testing the update

If you want to test the update process you'll need to do 2 things:

  1. Make a duplicate of your "1.1" version of your app (including the "client.wyc" and "wyUpdate.exe" files).

  2. Run your app (if you're using the AutomaticUpdater) or just run wyUpdate.exe (if you're using it as a standalone updater).

Note: You don't want to test updating over your original files. Always make a copy of the folder to do the testing.

(Optional) Build your new installer

When you're building your installer, include all of your app files and folders along with the newly re-built "wyUpdate.exe" and "client.wyc" for version 1.2 of your app.

Including files with your installer