My Idea Factory - By Ludovic Perrichon

Office365, Yeoman, Add-ins

Yoeman - Set O365 add-ins dev environment

This article is a bit old. You can find a recent one here : https://dev.office.com/docs/add-ins/get-started/create-an-office-add-in-using-any-editor

In this post I will explain what I did to set my first development environment for office 365 add-ins with yoeman.

Firstable download and install GITHUB Desktop.
https://desktop.github.com/

Download and install Node.js
https://nodejs.org/en/

Ok, now we are going to install few things with node command prompt (npm). You can install it :

  1. Globally : You will be able to access to the program everywhere. Just one install is required.
  2. In a folder : If you make a project in another folder, you will have to install it again.

Now open a command prompt window and run :

npm install npm -g

This will install the node command.

You have to install Gulp. Well there are two way to do it :

  1. Install it globally with
    npm install gulp -g
  2. The one I choose for this article is to create a folder and install Gult into that folder.
    cd path\to\your\folder
    npm install gulp
    

If everthings went well, you will be able to see a node_modules folder.

Now you have to install Bower. Two ways :

  1. Globally
    npm install -g bower
  2. In the folder
    cd path\to\your\folder
    npm install bower

Then you have to install TSD. Two ways :

  1. Globally
    npm install tsd -g
  2. In the folder
    cd path\to\your\folder
    npm install tsd

Be careful : TSD is deprecated ! Typings should be use instead. I haven't try it yet so it won't appear in this post for the moment. A future update will come as soon as I will try Typings.

Let's keep going. Let's install Yeoman. Two ways :

  1. Globally
    npm install yo -g
  2. In the folder
    cd path\to\your\folder
    npm install yo

I used globally for yeoman this time.

Install Generator Office. Two ways :

  1. Globally
    npm install generator-office -g
  2. In the folder
    cd path\to\your\folder
    npm install generator-office

Ok ! Everything is installed ! I explained step by step to give link and to see what we have to install. But you can install it with one command ! If you did the step above, skip this installation to Set your Office 365 environment to develop Add-ins with Yoeamn. Well after your node.js installation, run the following one :

  1. Globally
    npm install -g tsd bower gulp yo generator-office
  2. In the folder
    cd path\to\your\folder
    npm install tsd bower gulp yo generator-office

Set your Office 365 environment to develop Add-ins with Yoeamn.

In the command prompt, go to your project folder, and run yo office :

cd path\to\your\folder
yo office

Yeoman is going to ask you few questions about your new project :

  • Your Project name
  • If you want to create your project in the root folder or in a subfoder
  • The Office project type you want (task pane, mail, content). More informations https://dev.office.com/docs/add-ins/overview/office-add-ins
  • Which are the Supported Office applications. It's a multichoice question.
  • The Technology you want to use

And let's go !
If everything works well, that's it ! Have fun !

Wait I have an error !
You might have an error. And if you check your log you can see :
error fatal: unable to connect to git.gnome.org:
Well this problem come from your proxy. Check your proxy parameters and try it again. If you google the error, you will be able to find some get around solutions.