So you’re writing an interface and you make some useful routines and then you realize that you’d like to use this library in other components.
How do you do this?
You can create libraries which are then re-usable from any other Iguana X component.
Click the Create Folder icon
Enter the folder name and click and click the green [CREATE] button
You should see something like this:
Select the Create File menu optin on the FOO folder
Enter the folder name and click and click the green [CREATE] button
Create a function in the BAR.lua file, you can paste this example:
function FOObar() return "The world needs more FOO"; end
You should see something like this:
Click the Commit changes toolbar button
The commit dialogue will open, enter a commit message and click the green [COMMIT] button
Click the Push changes to remote toolbar button
The upstream repository will look something like this:
NOTE: FOO is currently just a folder
Open the folder menu by right clicking on FOO, or clicking the 3 dot menu
Choose Create Library to convert the FOO folder into a Library
Click the green [CREATE] button in the confirmation dialogue
This will bring you to the Repository Management dialogue
Once you are in the Repository Management screen you can set your upstream repository
Enter the name (also called a slug) for the repository
To create a new repository enter a repo name (slug) that does not exist yet
Click the [CONFIRM CHANGE] button to connect or create
It is possible to connect to an existing repository in the Repository Management dialogue – but we strongly recommend against this as there a few, if any, scenarios where this would be useful.
See Step 5 for detailed screenshots (the first three steps below are the same)
Click the Commit changes toolbar button
The commit dialogue will open, enter a commit message and click the green [COMMIT] button
Click the Push changes to remote toolbar button
The component upstream repository will look something like this:
NOTE: Notice that FOO was converted from a folder (in step 3) to a reference to the FOO library
The FOO library upstream repository will look something like this:
NOTE: That the the FOO library should have the BAR.lua file in it.
Get the FOO library URL
Choose View Remote menu option for the FOO library
Right click on the URL to copy URL
Edit the target component in the Translator
This is the component you will add the FOO library into
Click the Add library button to open the Import Library dialogue
Enter the FOO library details in the LIBRARY DETAILS section of the Import Library dialogue
Type in the library name FOO
Paste the URL you copied above into the GIT url field
Click the green [IMPORT] button to import the library
You can also add your libraries to a collection so they will show up in the Import Library dialogue list.
Choose the Add to Collection option from the right click menu
Choose an existing collection or create a new collection in the Add to collection dialogue
If you choose an existing collection your library will immediately show in the Import Library list
If you create a new collection you will need to add it to Settings → Git Collection
In this example I will choose an existing collection Test Lib collection
This will open the Edit Collection dialogue for the chosen collection
Here I can edit the details for libraries in this collection
In this case I will just update the description for FOO
Click the green [SAVE] button to add the new library
Now when I open the Add Library dialogue and filter for FOO it is there in the list
