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 :
- Globally : You will be able to access to the program everywhere. Just one install is required.
- 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 :
-
Install it globally with
npm install gulp -g
-
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 :
-
Globally
npm install -g bower
-
In the folder
cd path\to\your\folder npm install bower
Then you have to install TSD. Two ways :
-
Globally
npm install tsd -g
-
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 :
-
Globally
npm install yo -g
-
In the folder
cd path\to\your\folder npm install yo
I used globally for yeoman this time.
Install Generator Office. Two ways :
-
Globally
npm install generator-office -g
-
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 :
-
Globally
npm install -g tsd bower gulp yo generator-office
-
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.