Documentation Maintenance.

v0.27.3
Robin Mills 5 years ago
parent cab9c56b4e
commit b207b733d8

@ -62,13 +62,13 @@ $ pip install conan --upgrade
```bash ```bash
$ conan --version $ conan --version
Conan version 1.4.1 Conan version 1.23.0
``` ```
<name id="1-3"></a> <name id="1-3"></a>
##### 1.3) Create a build directory<name id="1-3"></a> ##### 1.3) Create a build directory<name id="1-3"></a>
Create a build directory and will run the conan commands: Create a build directory and run the conan commands:
```bash ```bash
$ mkdir build $ mkdir build
@ -76,7 +76,22 @@ $ cd build
$ conan profile list $ conan profile list
``` ```
**IMPORTANT** _**Visual Studio Users**_ require the profile msvc2017Release64 in %HOMEPATH%\.conan\profiles\msvc2017Release64 <name id="1-4"></a>
##### 1.4) Build dependencies and install conan artefacts in your build directory</a>
Execute `$ conan install` pointing to the directory containing `conanfile.py`.
```bash
$ conan install .. --build missing # --profile msvc2019Release
```
_**Visual Studio Users**_ should use:
```bash
> $ conan install .. --build missing --profile msvc2019Release`
```
The profile msvc2019Release `%USERPROFILE%\.conan\profiles\msvc2019Release` is:
```ini ```ini
[build_requires] [build_requires]
@ -85,7 +100,7 @@ arch=x86_64
build_type=Release build_type=Release
compiler=Visual Studio compiler=Visual Studio
compiler.runtime=MD compiler.runtime=MD
compiler.version=15 compiler.version=16
os=Windows os=Windows
arch_build=x86_64 arch_build=x86_64
os_build=Windows os_build=Windows
@ -93,16 +108,7 @@ os_build=Windows
[env] [env]
``` ```
<name id="1-4"></a> Profiles for Visual Studio are discussed in detail here: [Visual Studio Notes](#2-2)
##### 1.4) Build dependencies and install conan artefacts in your build directory</a>
Execute `$ conan install` pointing to the directory containing `conanfile.py`.
```bash
$ conan install .. --build missing # --profile msvc2017Release64
```
_**Visual Studio Users**_ should use `--profile msvc2017Release64`
The output from this command is quite long as conan downloads or builds zlib, expat, curl and other dependencies. The output from this command is quite long as conan downloads or builds zlib, expat, curl and other dependencies.
@ -110,7 +116,7 @@ The output from this command is quite long as conan downloads or builds zlib, ex
##### 1.5) Execute cmake to generate build files for your environment. ##### 1.5) Execute cmake to generate build files for your environment.
```bash ```bash
$ cmake .. # -G "Visual Studio 15 2017 Win64" $ cmake .. # -G "Visual Studio 16 2019"
``` ```
<name id="1-6"></a> <name id="1-6"></a>
@ -182,13 +188,15 @@ I use the following batch file to start cmd.exe. I do this to reduce the comple
```bat ```bat
@echo off @echo off
setlocal setlocal
set "PATH=C:\Python37\;C:\Python37\Scripts;C:\Perl64\site\bin;C:\Perl64\bin;C:\WINDOWS\system32;C:\Program Files\Git\cmd;C:\Program Files\Git\usr\bin;c:\Program Files\cmake\bin;" cd %HOMEPATH%
cmd /S /K cd %HOMEDRIVE%%HOMEPATH% set "PATH=C:\Python34\;C:\Python27\;C:\Python27\Scripts;C:\Perl64\site\bin;C:\Perl64\bin;C:\WINDOWS\system32;C:\Program Files\Git\cmd;C:\Program Files\Git\usr\bin;c:\Program Files\cmake\bin;"
cmd
``` ```
### Profiles for Visual Studio ### Profiles for Visual Studio
Exiv2 v0.27 can be built with VS 2008, 2010, 2012, 2013, 2015 and 2017. Exiv2 v0.27 can be built with VS 2008, 2010, 2012, 2013, 2015 , 2017 and 2019.
Exiv2 v0.27.1 (and later) can be built with VS 2015, 2017 and 2019. I believe Exiv2 will build with 2013 and earlier, however we don't actively support these version of Visual Studio. Exiv2 v0.27.1 (and later) can be built with VS 2015, 2017 and 2019. I believe Exiv2 will build with 2013 and earlier, however we don't actively support these version of Visual Studio.
@ -204,7 +212,7 @@ Bits := { 64 | 32 } # 32 bit build is not provided for 2019
Examples: msvc2019Release msvc2017Release64 msvc2015Debug32 Examples: msvc2019Release msvc2017Release64 msvc2015Debug32
``` ```
The profile msvc2017Release64 is as follows: The profile msvc2019Release is as follows:
```ini ```ini
[build_requires] [build_requires]
@ -213,7 +221,7 @@ arch=x86_64
build_type=Release build_type=Release
compiler=Visual Studio compiler=Visual Studio
compiler.runtime=MD compiler.runtime=MD
compiler.version=15 compiler.version=16
os=Windows os=Windows
arch_build=x86_64 arch_build=x86_64
os_build=Windows os_build=Windows
@ -236,7 +244,7 @@ the default CMake generator. Always use the generator for your version of Visua
```bat ```bat
c:\....\exiv2\build> conan install .. --profile msvc2017Release64 --build missing c:\....\exiv2\build> conan install .. --profile msvc2017Release64 --build missing
c:\....\exiv2\build> cmake .. -G "Visual Studio 15 2017 Win64" c:\....\exiv2\build> cmake .. -G "Visual Studio 16 2019"
c:\....\exiv2\build> cmake --build . --config Release c:\....\exiv2\build> cmake --build . --config Release
``` ```
@ -251,7 +259,7 @@ CMake provides Generators for different editions of Visual Studio. The 64 and 3
##### 64 bit Release Build ##### 64 bit Release Build
| | Visual Studio 2017 | Visual Studio 2017 | Visual Studio 2015| | | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015|
|:---------|--------------------|--------------------|--------------| |:---------|--------------------|--------------------|--------------|
| _**conan install .. --profile**_ | msvc2019Release | msvc2017Release64 | msvc2015Release64 | | _**conan install .. --profile**_ | msvc2019Release | msvc2017Release64 | msvc2015Release64 |
| _**cmake -G**_ | "Visual Studio 16 2019" | "Visual Studio 15 2017 Win64" | "Visual Studio 14 2015 Win64" | | _**cmake -G**_ | "Visual Studio 16 2019" | "Visual Studio 15 2017 Win64" | "Visual Studio 14 2015 Win64" |
@ -544,7 +552,7 @@ Other platforms such as Cygwin are not supported by Adobe. Adobe/XMPsdk is buil
Applications which wish use the Adobe XMPsdk directly should build Exiv2 in this configuration and the Applications which wish use the Adobe XMPsdk directly should build Exiv2 in this configuration and the
library can be used by the application and Exiv2. The Adobe XMPsdk can be built as a static or shared library (.DLL) library can be used by the application and Exiv2. The Adobe XMPsdk can be built as a static or shared library (.DLL)
To build Exiv2 with Adobe XMPsdk 2016, should perform steps 1.1, 1.2 and 1.3 described above, then perform the following: To build Exiv2 with Adobe XMPsdk 2016, perform steps 1.1, 1.2 and 1.3 described above, then perform the following:
<name id="4-1"> <name id="4-1">
##### 4.1) Add a remote directory to conan's recipe search path ##### 4.1) Add a remote directory to conan's recipe search path
@ -599,4 +607,4 @@ $ cmake -DEXIV2_ENABLE_WEBREADY=ON -DEXIV2_ENABLE_CURL=ON -DEXIV2_ENABLE_SSH=ON
[TOC](#TOC) [TOC](#TOC)
Written by Robin Mills<br>robin@clanmills.com<br>Updated: 2019-04-18 Written by Robin Mills<br>robin@clanmills.com<br>Updated: 2020-04-01

@ -758,12 +758,13 @@ I use the following batch file to start the MinGW/msys2 64 bit bash shell from t
```bat ```bat
@echo off @echo off
setlocal setlocal
set "PATH=c:\msys64\usr\bin;c:\msys64\usr\local\bin;" set "PS1=\! MSYS64:\u@\h:\w \$ "
set "PS1=\! MSYS \u@\h:\w \$ " set PATH="/usr/local/bin/:/usr/bin:/mingw64/bin:/bin:/usr/sbin:/sbin"
set "HOME=c:\msys64\home\rmills" set "HOME=c:\msys64\home\%USERNAME%"
if NOT EXIST %HOME% mkdir %HOME% if NOT EXIST %HOME% mkdir %HOME%
cd %HOME% cd %HOME%
c:\msys64\usr\bin\bash.exe -norc c:\msys64\usr\bin\bash.exe -norc
``` ```
#### Install MinGW Dependencies #### Install MinGW Dependencies
@ -821,11 +822,12 @@ I use the following batch file "cygwin64.bat" to start the Cygwin/64 bash shell
```bat ```bat
@echo off @echo off
setlocal setlocal
set "PS1=\! CYGWIN \u@\h:\w \$ "
set "PATH=c:\cygwin64\usr\local\bin;c:\cygwin64\bin;c:\cygwin64\usr\bin;c:\cygwin64\usr\sbin;" set "PATH=c:\cygwin64\usr\local\bin;c:\cygwin64\bin;c:\cygwin64\usr\bin;c:\cygwin64\usr\sbin;"
if NOT EXIST %HOME% mkdir %HOME%
set "HOME=c:\cygwin64\home\rmills" set "HOME=c:\cygwin64\home\rmills"
cd %HOME% cd %HOME%
c:\cygwin64\bin\bash.exe -norc set "PS1=\! CYGWIN64:\u@\h:\w \$ "
bash.exe -norc
``` ```
[TOC](#TOC) [TOC](#TOC)
@ -846,8 +848,9 @@ I use the following batch file to start cmd.exe. I do this to reduce the comple
```bat ```bat
@echo off @echo off
setlocal setlocal
set "PATH=C:\Python37\;C:\Python37\Scripts;C:\Perl64\site\bin;C:\Perl64\bin;C:\WINDOWS\system32;C:\Program Files\Git\cmd;C:\Program Files\Git\usr\bin;c:\Program Files\cmake\bin;" cd %HOMEPATH%
cmd /S /K cd %HOMEDRIVE%%HOMEPATH% set "PATH=C:\Python37\;C:\Python27\;C:\Python27\Scripts;C:\Perl64\site\bin;C:\Perl64\bin;C:\WINDOWS\system32;C:\Program Files\Git\cmd;C:\Program Files\Git\usr\bin;c:\Program Files\cmake\bin;"
cmd
``` ```
[TOC](#TOC) [TOC](#TOC)
@ -859,7 +862,7 @@ Exiv2 can be built on many Unix and Linux distros. With v0.27.2, we are startin
I have provided notes here based on my experience with these platforms. Feedback is welcome. I have provided notes here based on my experience with these platforms. Feedback is welcome.
I am willing to support Exiv2 on other commercial Unix distributions such as AIX, HP-UX and OSF/1 provided you provide with an ssh account for your platform. I will require super-user privileges to install software. I am willing to support Exiv2 on other commercial Unix distributions such as AIX, HP-UX and OSF/1 if you provide with an ssh account for your platform. I will require super-user privileges to install software.
#### NetBSD #### NetBSD
@ -902,6 +905,4 @@ Work in progress: [https://github.com/Exiv2/exiv2/issues/902](https://github.co
[TOC](#TOC) [TOC](#TOC)
Robin Mills Written by Robin Mills<br>robin@clanmills.com<br>Updated: 2020-04-01
Revised: 2020-03-23

@ -4,6 +4,10 @@ Headline Features of Exiv2 v0.27.3
---------------------------------- ----------------------------------
To be written To be written
Changes since 0.27.2
--------------------
https://github.com/Exiv2/exiv2/milestone/5?closed=1
Headline Features of Exiv2 v0.27.2 Headline Features of Exiv2 v0.27.2
---------------------------------- ----------------------------------

Loading…
Cancel
Save