YXI Packaging and Installation
A modified process for packaging and installing Python tools is available to accommodate Python virtual environments and third-party library dependencies.
If your Python tool does not use a virtual environment or third-party libraries, complete the process outlined in Package a Tool.
If your tool uses a virtual environment or third-party libraries, complete the following steps to package your tool and its dependencies.
- Verify that you have setup a Python Virtual Environment and Dependencies.
- Run a pip freeze command from the Python virtual environment's \Scripts path.
C:\ProgramData\Alteryx\Tools\ExamplePythonSDKTool\Scripts>pip freeze > ..\requirements.txt
- Verify that the resulting text file only contains libraries that are used in the tool.
- Create a temporary working folder:
Do not copy any virtual environment files or folders, including:
- Copy all files that will be included in the YXI file, including the requirements file, into the temporary folder.
- Copy the
ToolNameConfig.xmlfile from the tool sub folder to the root of the temporary tool directory.
Config.xml, and open the file.
- Verify that the file is configured correctly and that all quotes are removed from the elements.
- Compress the contents of the temporary working folder into a zip file.
- Rename the .zip file to a .yxi file.
- Verify the conversion by double-clicking on the yxi file. Designer should show a tool installer window for your tool.
To begin the installation process...
- Verify you have an active internet connection.
- Double-click the .yxi file.
- Open Designer and select Open Workflow from the File menu to browse to the .yxi file.
If installing as an Administrator, the option to install for all users is available. On the tool installer window, select Install to complete the installation process.
If you receive an error during the installation process, there might be 2 issues.
- The files might not exist.
- You might need to enable Windows long paths.
Follow these steps:
- Open the Registry Editor (
- Go to HKEY_LOCAL_MACHINE/SYSTEM/CurrentControlSet\Control\FileSystem.
- Right-click on the key, and Export for backup.
- Change value
LongPathsEnabledfrom 0 to 1.
- Re-install the YXI again. You should not need to restart.
- Create a folder with the name of your tool. See Build Custom Tools.
- Create an icon and save it inside the tool folder. See Build Custom Tools.
- Create a GUI file and save it inside the folder. See HTML GUI SDK.
- Create your back end and save it inside the folder. See C++ SDK, Macro, and Python SDK.
- Create a configuration file and save it inside the folder. See Tool Configuration File.
- Create a package configuration file and save it with the folder. Package a Tool.
- Package the package configuration file and tool folder as a yxi. See Package a Tool.