Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

You can create libraries which are then re-usable from any other Iguana X component.

Create a Component

Expand
titleStep 1: Add a component using green [+ COMPONENT] button
Include Page
Create a ComponentCreate a Component
Start with a component which you have edit rights for and has a remote setup already.

If you need a reminder see Customizing components

Set an upstream repository & Set upstream Git repo

Expand
titleStep 2: Make sure it has an upstream repo
Include Page
Set an upstream repositorySet an upstream repository
Expand
titleStep 3: Create a directory FOO

Click on the

Create Folder iconImage Removed
  • Enter the folder name and click and click the green [CREATE] button

    Image Removed
  • You should see something like this:

    Image Removed
  • new folder icon and name the folder FOO.

    Image Added

  • Select the Create File menu optin on the FOO folder

    Image Removed
  • Enter the folder name and click and click the green [CREATE] button

    Image Removed
  • Create a function in the BAR.lua file, you can paste this example
    Expand
    titleStep 43: Create a file BARFOObar.lua in the FOO directory and add a function
    FOObar

    Start here:

    Image Added

    In the context menu that comes up select Create File and create a FOObar.lua file with this content:

    Code Block
    function FOObar()
       return "The world needs more FOO";
    end
  • You should see something like this:

    Image Removed
  • Click the Commit changes toolbar button

    Image Removed
  • The commit dialogue will open, enter a commit message and click the green [COMMIT] button

  • Click the Push changes to remote toolbar button

    Image Removed
  • The upstream repository will look something like this:
    NOTE: FOO is currently just a folder

    Image Removed

    Expand
    titleStep 5: Commit the changes and push them to the upstream repo
    4: Invoke Create Library from the FOO folder ellipsis menu:
    Image Added

    Click CREATE

    • 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

      Image Removed
    • 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
    Expand
    titleStep 6: Convert FOO to a library by right clicking on it and choosing the "Create Library" menu option
    Note
    5: Fill out the repository management screen to determine what remote git repository to put the library code in:

    See Repository Management Screen if you need a refresher about this.

    Expand
    titleStep 76: Commit and push the FOO library changes

    See Step 5 for detailed screenshots (the first three steps below are the same)

    Click the

    Commit

    changes toolbar buttonThe 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

    Image Removed
  • The FOO library upstream repository will look something like this:
    NOTE: That the the FOO library should have the BAR.lua file in it.

    Image Removed
  • Expand
    titleStep 8: Now create a new component + FROM URL based on the git repo of this library

    Bang - this work flow is currently broken as of 10.1.80Push Changes to Git

    Expand
    titleStep 7: After this the code will be in the remote git repository you configured it to be in

    You should able to go to the Repository Management Screen and from there navigate to the remote repository to see your changes.