NameDateSize

..16-Mar-201612 KiB

.gitattributes31-Oct-20131.4 KiB

.gitignore09-Dec-20158.3 KiB

.gitmodules09-Dec-20152.2 KiB

ChangeLog29-Dec-20121.6 KiB

code_of_conduct.md09-Dec-20152.3 KiB

configure09-Dec-20158.6 KiB

dependency_checker.rb12-Oct-20152 KiB

extras/17-Jun-20154 KiB

main/11-Dec-20154 KiB

Makefile09-Dec-20153.9 KiB

MonoDevelop.mdw29-Dec-2012157

profiles/11-Dec-20154 KiB

README.md09-Dec-20154.6 KiB

scripts/09-Dec-20154 KiB

setup/14-Feb-20124 KiB

version-checks15-Dec-20153.9 KiB

version.config09-Dec-201540

README.md

1**MonoDevelop** is a full-featured integrated development environment (IDE) for mono using Gtk#.
2
3See http://www.monodevelop.com for more info.  
4
5[![Build Status](http://jenkins.mono-project.com/job/test-monodevelop-mainline/badge/icon)](http://jenkins.mono-project.com/job/test-monodevelop-mainline/)
6
7[![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/mono/monodevelop?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
8
9Directory organization
10----------------------
11
12There are two main directories:
13
14 * `main`: The core MonoDevelop assemblies and add-ins (all in a single
15    tarball/package).
16 * `extras`: Additional add-ins (each add-in has its own
17    tarball/package).
18
19Compiling
20---------
21
22If you are building from Git, make sure that you initialize the submodules
23that are part of this repository by executing:
24`git submodule update --init --recursive`
25
26If you are running a parallel mono installation, make sure to run all the following steps
27while having sourced your mono installation script. (source path/to/my-environment-script)
28See: http://www.mono-project.com/Parallel_Mono_Environments
29
30To compile execute:
31`./configure ; make`
32
33There are two variables you can set when running `configure`:
34
35* The install prefix: `--prefix=/path/to/prefix`
36
37  * To install with the rest of the assemblies, use:
38  `--prefix="pkg-config --variable=prefix mono"`
39
40* The build profile: `--profile=profile-name`
41
42  * `stable`: builds the MonoDevelop core and some stable extra add-ins.
43  * `core`: builds the MonoDevelop core only.
44  * `all`: builds everything
45  * `mac`: builds for Mac OS X
46  * You can also create your own profile by adding a file to the profiles
47directory containing a list of the directories to build.
48
49Disclaimer: Please be aware that the 'extras/JavaBinding' and 'extras/ValaBinding' packages do not currently work. When prompted or by manually selecting them during the './configure --select' step, make sure they stay deselected. (deselected by default)
50
51Running
52-------
53
54You can run MonoDevelop from the build directory by executing:
55`make run`
56
57Installing *(Optional)*
58----------
59
60You can install MonoDevelop by running:
61`make install`
62
63Bear in mind that if you are installing under a custom prefix, you may need to modify your `/etc/ld.so.conf` or `LD_LIBRARY_PATH` to ensure that any required native libraries are found correctly.
64
65*(It's possible that you need to install for your locale to be
66correctly set.)*
67
68Packaging for OS X
69-----------------
70
71To package MonoDevelop for OS X in a convenient MonoDevelop.app
72file, just do this after MonoDevelop has finished building (with
73`make`): `cd main/build/MacOSX ; make`.
74You can run MonoDevelop: `open MonoDevelop.app` or build dmg package: `./make-dmg-bundle.sh`
75
76Dependencies
77------------
78
79- [Windows](https://github.com/mono/md-website/blob/gh-pages/developers/building-monodevelop.md#prerequisites-and-source)
80- [Unix](http://www.monodevelop.com/developers/building-monodevelop/#linux)
81
82Special Environment Variables
83-----------------------------
84
85**BUILD_REVISION**
86
87	If this environment variable exists we assume we are compiling inside wrench.
88	We use this to enable raygun only for 'release' builds and not for normal
89	developer builds compiled on a dev machine with 'make && make run'.
90	
91
92Known Problems
93-----------------------------
94
95"The type `GLib.IIcon' is defined in an assembly that is not referenced"
96This happens when you accidentally installed gtk-sharp3 instead of the 2.12.x branch version.
97Make sure to 'make uninstall' or otherwise remove the gtk-sharp3 version and install the older one.
98
99xbuild may still cache a reference to assemblies that you may have accidentally installed into your mono installation,
100like the gtk-sharp3 as described before. You can delete the cache in $HOME/.config/xbuild/pkgconfig-cache-2.xml
101
102
103
104References
105----------
106
107**MonoDevelop website**
108
109http://www.monodevelop.com
110
111**Gnome Human Interface Guidelines (HIG)**
112
113https://developer.gnome.org/hig/stable/
114
115**freedesktop.org standards**
116
117http://freedesktop.org/Standards/
118
119**Integrating with GNOME** *(a little out of date)*
120
121http://developers.sun.com/solaris/articles/integrating_gnome.html
122
123**Bugzilla**
124
125http://bugzilla.mozilla.org/bugwritinghelp.html
126
127http://bugzilla.mozilla.org/page.cgi?id=etiquette.html
128
129Discussion, Bugs, Patches
130-------------------------
131
132monodevelop-list@lists.ximian.com *(questions and discussion)*
133
134monodevelop-patches-list@lists.ximian.com *(track commits to MonoDevelop)*
135
136monodevelop-bugs@lists.ximian.com *(track MonoDevelop bugzilla component)*
137
138http://bugzilla.xamarin.com *(submit bugs and patches here)*
139
140