Processing Messages

When your content processing is finished, you may be notified of progressing warnings or errors. On this page, you may learn more details about both of them.

Your patch file size is nearly the same as your content file size

When you’re uploading new application files, a patch file is created. The patch file is meant to be as small as possible, so if it is similar to your full application size, it is considered a mistake.

Why is it wrong?

Big patch file means that every update requires from your users to download a lot of unnecessary data. That would take much time and may frustrate your users.

How to fix it?

There may be several reasons:

  1. You’ve uploaded a zip file with the different application. If you upload a zip file that is an entirely different application by mistake, there’s no chance of creating a valid patch. Look at the file listing to make sure that you’ve chosen the files that you’d like to upload.
  2. You’ve changed the name of files or directories. PatchKit currently does not support path changes, so it treats every rename as a delete/add operation.
  3. You’re working with Unity, and you’ve changed your build name. Changing a build name in Unity also changes *_Data directory name. That is a similar situation to the one from point 2. Please make sure to name your builds in the same manner on each release.

Cannot find the executable file

PatchKit cannot find an executable file within your application files.

Why is it wrong?

PatchKit needs to know which file is executable to launch your application when it is downloaded.

How to fix it?

PatchKit is automatically looking for executable files, so if it cannot find it, most probably you’ve made one of these mistakes:

  1. You’ve set your Target Platform to something else that your application is built for. For instance, you’re sending a Windows build, but your target platform is set to Linux.
  2. You did not include an executable file in the top directory of your content.
  3. Your executable file is corrupted.

Application platform mismatch

This error means that PatchKit has found files that belong to a different platform than the one your Target Platform option is set to.

Why is it wrong?

Files that are not prepared for your target platform are unusable. Your application may throw an error when you try to do something with them.

How to fix it?

In some cases, these files are safe to be removed because it may mean that you’re making a multi-platform application but you made a configuration mistake and these files can be found in your target build. Also, if you’re sure that you’ve built your application correctly, leaving these files shouldn’t do much harm.

Make sure to consider that and decide if you want to make any action or ignore it.

Compression Method set to LZ4 or LZ4HC (Unity builds)

Starting from Unity 2017.2 there’s a new option in Build Settings called Compression Method. If you’re receiving this message then most probably your application has been built with Compression Method set to LZ4 or LZ4HC.

Compression method

Why is it wrong?

Compressing your game build breaks the binary patch file by creating an algorithm. This algorithm is looking for differences in your binary files so that it can be as small as possible. For example, changing a texture should result in a patch file that closely resembles this texture size.

By enabling compression, you’re making these kinds of changes impossible to detect. Compression algorithms can generate entirely different output, even if the change is minimal.

On top of that, PatchKit on its own is applying compression to your files at the final stage of version processing, so you don’t have to worry about your build size.

How to fix it?

Just go into the Files/Build Settings window, set Compression Method to None and build your application one more time.

Did this page help you? If you have any questions, don't hesitate and contact us.

Copyright © 2015 - 2022 Upsoft
All Rights Reserved.