Jump to content


Photo

How can I compile the source code?

faq

  • This topic is locked This topic is locked
No replies to this topic

#1 Staff

Staff

    Advanced Member

  • Staff
  • PipPipPip
  • 7328 posts

Posted 26 November 2014 - 02:00 PM

How can I compile the source code?


The AirVPN Client (codename Eddie) is a free and open source OpenVPN wrapper that's fully integrated with the AirVPN service.
It's licensed under GPL, sources are available on GitHub.

The software uses Mono Framework, with WinForms under Windows and Linux, and Xamarin.Mac under OS X.

Building instructions are related to OS, development tools etc. If you have a specific environment question, open a topic in the software subforum.

Windows

- Download and install Visual Studio 2017 Community Edition from Microsoft website.
- Clone the GitHub project: https://github.com/AirVPN/Eddie with TortoiseGit or equivalent software, or download the .zip

Method 1 (direct build):

  • Launch repository/build_windows.bat
    This generates all distribution files under repository/files folder.

Method 2 (debug/develop):

  • Open from Visual Studio 2017 the solution src/eddie2_windows.sln
  • Switch to Debug and x64
  • Set "App.Forms.Windows" as Startup Project
  • Debug > Start Debug


Linux


Make sure you have the latest Mono: http://www.mono-project.com/docs/getting-started/install/linux/
Under Debian derivatives, required packages:

apt-get update
apt-get install mono-complete
apt-get install lintian # Optional, to build .deb
apt-get install rpm # Optional, to build .rpm
apt-get install tar
apt-get install curl

zlib1g-dev may be required.

Method 1 (direct build):

  • Clone the GitHub project: https://github.com/AirVPN/Eddie

    For example from root terminal:
    apt-get install git git-core
    and from user terminal:
    cd ~/Documents
    git clone https://github.com/AirVPN/Eddie.git
    
  • Launch repository/build_linux.sh
    This generate all distribution files under repository/files folder.

Method 2 (debug/develop):

  • Install MonoDevelop (go here for more info), install packages monodevelop and monodevelop-versioncontrol
  • Launch MonoDevelop
    Important note: if you don't want to simply compile it, but you want to debug it, you need to launch MonoDevelop as root (sudo monodevelop). We know it isn't the best practice, but there isn't any known alternative.
  • Menu -> Version Control, Protocol: https, Url:
    https://github.com/AirVPN/Eddie.git
  • Open <home>/src/eddie2_linux.sln
  • Select Debug|X64
  • Right click on App.Forms.Linux, Rebuild App.Forms.Linux
  • If you run it as root, you can debug it:
    Run -> Debug



OS X / macOS

  • Building the OS X version currently requires a standard license of Xamarin Studio, because the UI is written with Xamarin.Mac namespace. Console-edition may be built with MonoMac.

 

Android

The following guide uses Windows. The procedure may be similar under macOS.

 

  • Clone the GitHub project: https://github.com/AirVPN/Eddie
  • In src\UI.Xamarin.Android\native\ extract the content of native.7z in the same directory. It contains third-party libraries: precompiled binaries and includes.
  • Install Microsoft Visual Studio 2017 - Community Edition - Check Mobile Support (Xamarin) during installation.
  • Enable USB Debug on your smartphone and connect it.
  • Open src/eddie2.mobile.sln in Visual Studio. At this point, Visual Studio will start to download automatically any dependency.
  • Switch to Debug | ... | <Your Android device>
  • Run -> Debug

 

If you need to recompile (for changes) Eddie.Android.Native, don't build from Visual Studio, install NDK and use src\UI.Xamarin.Android\native\build.bat .

 








Also tagged with one or more of these keywords: faq

1 user(s) are reading this topic

0 members, 1 guests, 0 anonymous users

Servers online. Online Sessions: 13407 - BW: 35960 Mbit/sYour IP: 54.81.244.248Guest Access.