Page MenuHomePhabricator
Files F7232023

No OneTemporary
Actions

View Options

diff --git a/docs/Install.windows b/docs/Install.windows
index 22da74ba..b0cdeedf 100644
--- a/docs/Install.windows
+++ b/docs/Install.windows
@@ -1,153 +1,151 @@
SIP SIMPLE client SDK installation on Microsoft Windows
-------------------------------------------------------
Copyright (c) 2008-2014 AG Projects
http://ag-projects.com
Home page: http://sipsimpleclient.org
This document describes the installation procedure on Microsoft Windows
operating systems. Supported versions are Windows XP or higher.
Step 1. Prerequisites
---------------------
The building process is designed to work with the MSYS2 environment and the
MinGW-w64 compiler toolchain. Other approaches might work but they are not
tested nor supported.
MSYS2: MSYS2 is a minimal Unix-like environment for Windows. It includes a port
of the 'pacman' package manager (ported from Arch Linux) and a pretty extensive
collection of packages which can be easily installed. It contains packages for the
MinGW-w64 toolchain, for 32 and 64 bit architectures.
MinGW-w64: MinGW is a minimal compilation toolchain for Windows. It contains GCC and
allows for compilation of native applications for Windows. The original MinGW project
(available at http://mingw.org, henceforth referred to as 'MinGW32') didn't support
64 bit Windows so the MinGW-w64 project was created. It contains support for both 32
and 64 bit architectures and generally it's better maintained than MinGW32.
Step 1.1. Installing MSYS2 and MinGW-w64
----------------------------------------
The following instructions will guide you through the installation of a MSYS2 and MinGW-w64
installation for a 32 bit Windows system. A 64 bit build is definitely possible but
hasn't been tested.
* Go to http://msys2.github.io and download the most recent 32 bit (i686) MSYS2 installer
* Run it and install it on C:\msys2 (or any other path, but note it has to be ASCII
only and with no spaces!)
* Once the process is finished, check the box to "Run MSYS2 32bit now", a new terminal
window will appear
-* Upgrade the system packages by running: pacman -Syu
-* If you get an error about some "base mismatch detected", close the terminal, go to the
- folder where you installed MSYS2, run autorebase.bat and then open the terminal again
- by running msys2_shell.bat. Run pacman -Syu once more to make sure everything got updated
-* Install GCC by running: pacman -S mingw-w64-i686-gcc
+* Upgrade the system packages by following these instructions:
+ https://sourceforge.net/p/msys2/wiki/MSYS2%20installation/
+* Install the compiler toolchain: pacman -S mingw-w64-i686-toolchain
* Install the usual utilities for compiling software: pacman -S make mingw-w64-i686-libtool autoconf automake-wrapper mingw-w64-i686-pkgconf
* Install some extra useful utilities: pacman -S openssh wget
After MSYS2 was installed a new menu group was created on the Window start menu: "MSYS2 32bit",
which contains 3 links: MinGW-w64 Win32 Shell, MinGW-w64 Win64 Shell and MSYS2 Shell. We'll
use "MinGW-w64 Win32 Shell" from now on, since it will contain the 32 bit MinGW-w64 toolchain
in the path.
Step 1.2. Installing Python 2.7
-------------------------------
In order to avoid problems derived from using multiple C runtimes, we are going to
install Python 2.7 using pacman. The Python binaries that are available for download
on Python's official website are compiled with Visual Studio, and if we use MinGW
to compile libraries which are then used by Python modules we are at risk because
the resulting application would load 2 different C runtimes.
* Install Python 2.7 by running: pacman -S mingw-w64-i686-python2
* Get the pip/setuptools installer: wget https://bootstrap.pypa.io/get-pip.py
* Install pip/setuptools: python get-pip.py
NOTE: At the time of this writing the Python REPL needs to be started with "python -i" due to
a problem with the ncurses libraries.
Step 2. Install dependencies
----------------------------
See Dependencies.txt for detailed description of the required libraries and
their minimum version number.
* Install required dependencies with pacman: pacman -S mingw-w64-i686-gnutls mingw-w64-i686-python2-lxml
* Install the Python package dependencies: pip install cython dnspython twisted python-dateutil greenlet python-application python-cjson python-gnutls
Step 3. Install SIP SIMPLE client SDK
-------------------------------------
Before we can install the SDK we'll need to install darcs, since some
packages need to be installed with it.
* Download the installer from darcs.net: http://darcs.net/binaries/windows/darcs-2.8.1-win1.msi
* Install Darcs and add the directory to the system path
The SDK consists of four parts:
1. python-eventlib
2. XCAP library
3. MSRP library
4. SIP SIMPLE library
Make sure that the path where you download the software below does not
contain any space in its name.
# Eventlib
if [ -d python-eventlib ]; then
cd python-eventlib
darcs pull -a
else
darcs get http://devel.ag-projects.com/repositories/python-eventlib
cd python-eventlib
fi
pip install .
cd ..
# XCAP library
if [ -d python-xcaplib ]; then
cd python-xcaplib
darcs pull -a
else
darcs get http://devel.ag-projects.com/repositories/python-xcaplib
cd python-xcaplib
fi
pip install .
cd ..
# MSRP library
if [ -d python-msrplib ]; then
cd python-msrplib
darcs pull -a
else
darcs get http://devel.ag-projects.com/repositories/python-msrplib
cd python-msrplib
fi
pip install .
cd ..
# SIP SIMPLE
if [ -d python-sipsimple ]; then
cd python-sipsimple
darcs pull -a
else
darcs get --set-scripts-executable http://devel.ag-projects.com/repositories/python-sipsimple
cd python-sipsimple
fi
./build_inplace --pjsip-clean-compile
python setup.py install
cd ..
The software has been installed in C:\msys2\mingw32\lib\python2.7\site-packages

File Metadata

Mime Type
text/x-diff
Expires
Sat, Dec 28, 3:25 AM (1 d, 1 h)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
3454203
Default Alt Text
(5 KB)

Event Timeline