What is customize-uploader?
The tool is published on npm and is available for Windows, macOS, and Linux.
Find the source code on GitHub.
* Node.js version 6 or later is needed to use this tool.
Execute this command to install customize-uploader globally using npm:
Creating the manifest file
A manifest file needs to be created to use customize-uploader. It should contain the App ID of the App to upload the customization files to, as well as paths to the customization files themselves. Place the manifest file in the same hierarchy as the files to be uploaded, and update the manifest file with the following information.
- app: App ID of the App to upload the files to
- scope: Scope of customization ("ALL" || "ADMIN" || "NONE")
When using a library from the Kintone CDN, input the URL of the library.
An example of a completed customize-manifest.json file is shown below.
Customize-uploader needs to specify the Kintone subdomain information when run.
There are three ways to enter the required information.
* Customize-uploader must be run by a user with administrator privileges of the applicable App.
Enter subdomain information, login name, and password as options in addition to the manifest file.
Specifying only the manifest file will prompt an interactive question and answer feature to enter domain information, login name, and password.
Specification using environment variables
Environment variables can be used by setting the Kintone subdomain, login name, password etc. as environment variables beforehand. This is useful when it is important for passwords and other sensitive information to not be displayed on the screen when executing commands.
There are options in addition to the subdomain and login information that can also be used.
A file can be uploaded automatically onto Kintone each time a change is made by monitoring file updates with the --watch option. Using this option prevents the need to continually re-upload customization files by hand when changes are being made to the code often.
* To stop monitoring, cancel the command with ctrl + c.
Customization files can be uploaded to an App in a Guest Space using the --guest-space-id option.
The display language on the command line can be specified using the --lang option. Currently, either English (en) or Japanese (ja) can be specified.
When using a proxy server, proxy information can be entered using the --proxy option.
A customize-manifest.json file is generated using the init subcommand.
Import App customization information into the customize-manifest.json file using the import subcommand.
With the customize-uploader, files for customizations can be uploaded using only the command line.
Additionally with the --watch option, changes to customization files are immediately reflected in the App without needing to use file management tools such as Dropbox.
Note that tech support is not available for the customize-uploader tool.
For questions or comments about the customize-uploader tool, post a topic in the Kintone Developer Program Community. Modification, redistribution, and commercial use of the source code are subject to the license agreement.