Velocity File Assistant

Velocity File Assistant is a small Android application that helps you configure Velocity. It copies configuration files from a place that a human or MDM (Mobile Device Management) client can put them to the app storage that Velocity can access.

Watch a video about File Assistant (4:24)

Velocity File Assistant is designed for devices that are running Android 11 or newer. In version 11, Android introduced restrictions that prevent Velocity from reading files from the storage where MDM clients put them. (The MDM client can't see where Velocity keeps its files, and Velocity can't see where the MDM client keeps its files.) Velocity File Assistant uses the Manage External Storage permission to move the files from where the MDM client can see them to where Velocity can see them. Assign the permission using your MDM, or Velocity File Assistant will ask for the permission the first time it runs.

Velocity File Assistant checks the internal storage location /com.wavelink.velocity first. If the directory doesn't exist or is empty, Velocity File Assistant checks in /Download/com.wavelink.velocity. All the files in the source directory are copied to the destination directory: /Android/data/com.wavelink.velocity/files. If there are directories inside the source directory, those directories and any files they contain are NOT copied.

The Velocity File Assistant runs each time the Velocity Client is launched. It does not need to be run separately, and it does not create a home screen icon, but it does show in the app list in Settings > Apps.

When Velocity File Assistant is launched by the Velocity Client, it does not delete any files. However, if you are using an MDM client, you can use an intent to launch Velocity File Assistant and it will delete any existing configuration files in the destination directory before it begins to copy the new files.

To use Velocity File Assistant to copy files: 

1.Download the Velocity File Assistant app from the Wavelink downloads page and install it on a Android device that has Velocity 2.1.21 or newer installed.

2.Copy the configuration files to one of the source directories on the device.

3.Launch Velocity. The Velocity File Assistant launches, copies the files, shows a status message, and then closes. The Velocity Client finishes loading as soon as the Velocity File Assistant is done.

To use Velocity File Assistant to replace files: 

1.Download the Velocity File Assistant app from the Wavelink downloads page and install it on a Android device that has Velocity 2.1.21 or newer installed.

2.Copy the configuration files to one of the source directories on the device.

3.Use an MDM client to send a startActivity intent to launch the Velocity File Assistant (com.wavelink.velocityfileassistant). Set the extra com.wavelink.velocityfileassistant.extra.CLEAN to true. The way the intent is formatted may vary based on your MDM.

Velocity File Assistant deletes the files from the /Android/data/com.wavelink.velocity/files directory and then copies the files from /com.wavelink.velocity . If you use startActivityForResult(), the activity returns RESULT_OK when no problems are encountered, and returns RESULT_CANCELED when problems are encountered. Velocity File Assistant closes when it is done.