Skip to content

This is the add-in deployment tool for the PowerPointLabs project

Notifications You must be signed in to change notification settings

PowerPointLabs/DeployHelper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 

Repository files navigation

DeployHelper

This is the add-in deployment tool for the PowerPointLabs project.
Build status

What does it do

  • Patch the add-in VSTO manifest to support post-install features (e.g. open a tutorial file after install).
  • Produce web installer package or standalone installer package.
  • Upload the package to the server with correct permissions.

How to use

Setup

  1. Get DeployHelper artifacts here.
  2. Get DeployHelper.conf here and fill it with the correct settings*.
    • Mage is a component provided by Visual Studio to sign VSTO manifest
    • Key is the deployment certificate (not the dev one, AKA PowerPointLabs.dev.pfx)
    • SFTP address is the server to upload to
    • SFTP username is the username used to login the server
    • Dev path is the installation folder path on the server for dev-release
    • Release path is the installation folder path on the server for public-release
  3. Put DeployHelper artifacts and DeployHelper.conf into a folder, AKA the publish folder.
  4. In the publish folder, create a new folder named online. Put Tutorial.pptx, registry.reg, PowerPointLabsOnline.SED and setup.bat into it.
  5. In the publish folder, create a new folder named offline. Put Tutorial.pptx, PowerPointLabsOffline.SED and setup.exe (rename PowerPointLabsInstallerUi.exe to setup.exe) into it.
  6. Update TargetName and SourceFiles0 of PowerPointLabsOnline.SED and PowerPointLabsOffline.SED with the path of publish folder.

Deploy

  1. If there is newer version of Tutorial.pptx, update it in the online and offline folder.
  2. Make sure you're in the correct branch:
    • dev-release branch is for dev-release with web/online installer
    • release-standalone branch is for public-release with standalone/offline installer
    • release-web branch is for public-release with web/online installer
  3. Make sure the codes are ALL GREEN (can build & all test cases passed).
  4. Publish the PowerPointLabs project:
    • Update the Version and ReleaseDate in the Settings
    • Update the ReleaseType (dev|release) and InstallerType (online|offline) in the Settings
      • dev: for dev-release and dog-fooding
      • release: for public-release
      • online: to produce and upload web installer package
      • offline: to produce and upload standalone installer package
    • For InstallerType offline, leave Installer Folder URL blank in the project properties.
    • For InstallerType online, update Installer Folder URL to be the correct URL (dev or release)*.
    • Publish the project to the publish folder
  5. Run DeployHelper.exe in the publish folder and follow the instructions.
  6. Verify the deployment*.
  7. Add tags in Git for the released versions.

* Details can be found in the internal documents.

About

This is the add-in deployment tool for the PowerPointLabs project

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages