Giter VIP home page Giter VIP logo

navertical's Introduction

NaverticAl

NaverticAl is extension for every Microsoft Dynamics 365 Busines Central developer.

Features

  • Create new AL App folder from template by using "Navertical:Go!" command.
  • Create/Remove docker environment
  • Compile AL App with dependencies
  • Install AL Apps with dependencies
  • Uninstall AL Apps with dependencies

How to use

  1. Create new AL App folder by using navertical:Go! This command will:
    • Ask for empty folder path
    • Ask for new App name (suggested the empty folder name)
    • Ask for new Repository URL
    • Clone template repository
    • Update the app.json with new id and app name (including dependency of TestApp)
    • Rename Workspace file based on App name
    • Open the Workspace
  2. Create Docker environment by using navertical:Create environment This command will:
    • Create new docker container with name and image based on the settings in Settings.ps1
    • Make alc.exe compiler available from outside the container to allow compilation of the apps (may be will be changed later to compile inside container)
    • Import Test objects in the container to allow run App Tests
  3. Add dependency Apps into Dependencies folder as GIT Submodules (preffered) or directly
  4. Compile the Apps with navertical:Compile App Tree This command will:
    • Download system application app packages
    • Download App packages for dependencies when source code is not found in the App folder tree (MISSING FUNCTIONALITY)
    • Compile Apps in order to fullfill dependencies
    • Sign the Apps with CodeSigning certificate if navertical.CertPath is set
  5. Publish the Apps with navertical:Publish App Tree This command will:
    • Install the Apps in order to fullfill the dependencies
    • Publish the Apps
  6. To unpublish the Apps you can use navertical:Unpublish App Tree
  7. To remove environment you can use navertical:Remove Environment

Azure Pipeline

If you want to have CI pipeline created in your Azure DevOps, just push the App repository to your Azure Repository. If the Pipeline is not created automaticaly, go to your Azure Build Pipelines, click New, and select the repo. The Pipeline will be created automatically for you. If you want to change something in the pipeline, edit the Azure-pipelines.yml file accordingly. By pushing new version to the Azure Repo, new definition of the pipeline will be automatically used.

Requirements

All needed powershell scripts are installed by the extension (navcontainerhelper and NVRAppDevOps).

Related projects

As a template for new AL App is used MSDyn365BC_AppTemplate which uses MSDyn365BC_Yaml for Azure Pipeline creation.

Extension Settings

This extension contributes the following settings:

  • navertical.CertPath: set to path to CodeSigning certificate
  • navertical.IgnoreVerification: set to false to enable signature verification when installing the apps

Known Issues

Missing possibility to pull missing dependencies from package server.

Release Notes

0.1.1

Removed unused configurations Downgraded dependency event-stream to version 3.3.4 to remove malicious dependency

0.1.0

Fixed bug when reopening NaverticAl terminal, it used default terminal shell instead powershell (if different used)

0.0.2

Updated dependencies

0.0.1

Initial public release of the extension

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.