Installation and Compilation Guide

Table of Contents

• Library installation from a distribution file
• Compiling library from a source code
  • Library compilation with Xcode
  • Library compilation with command line interface

Samond Classes Library is available in compiled form and as a source code:

• Library installation from a distribution file
• Compiling library from a source code

Intstructions for using the library locates in the section Using Guide.
Classes and solutions located in the section Programming Guide.

If you have any questions about using the library, as well as various problems with use or compile the library, you can contact me at samon.nosp@m.d@ma.nosp@m.c.com.

---

Library installation from a distribution file

Installation from a distribution file supports only for the operating system macOS (and for building applications for the operating system iOS).

Distribution file is a DMG image that contains the following files and folders:

• Documentation - this documentation in an Apple DocSet format in English and Russion
• Include/scl - a library header files
• Frameworks - a compiled framework and static library for macOS (subfolder MacOS) and a static library for iOS (subfolder iOS)
• Sources - a library source code for all supported platforms

For library installation from a distribution file it is necessay to execute the following actions:

• download a distribution file from our official site
• mount an image by using Finder
• copy a content of the image file into the folder /Developer (if this folder does not exists, create it; if a folder /Developer already contrains the required subfolders then copy subfolders content into the appropriate /Developer subfolders)

Installing to a different location is permitted, but not recommended, because default path used with compiling project in Xcode.

---

Compiling library from a source code

You can compile a library both for operating systems macOS and iOS and for a GNUstep platform. This section contains a description of the building the library for macOS and iOS. If you want compile a library for the GNUstep platform, see a specified section of this documentation.

You can obtain a library source code by using:

• a folder Sources from a distribution image file
• our official site
• source version control system with one of commands:

  svn checkout https://svn.code.sf.net/p/sclmac/code/trunk sclmac
  svn checkout https://svn.code.sf.net/p/sclmac/code/stable sclmac

It is possible to compile library (or its separate components) one of the following methods

• Library compilation with Xcode
• Library compilation with command line interface

By default a library components write into the folder /Developer. If you want change this path, you must change the appropriate options in the project by using Xcode. Also by changing project settings you can specify a deployment target for the library.

---

Library compilation with Xcode

Open a project sclmac.xcodeproj in a Xcode and build by using a key combination Command + B or a menu item Product->Build one of the following targets:

• libscl-ios - a static library for the iOS devices (/Developer/Frameworks/iOS/Release-iphoneos/libscl.a)
• libscl-uni - an universal static libraty for iOS devices and simulators (/Developer/Frameworks/iOS/libscl.a)
• libscl-osx - статическая библиотека для операционной системы macOS (/Developer/Frameworks/MacOS/Release/libscl.a)
• scl-osx - a framework for the operating system macOS (/Developer/Frameworks/MacOS/Release/scl.framework)
• Documentation - this documentation (/Developer/Documentation)

Warning! If you downloaded a source code by using subversion, it is possible that documentation is build only in HTML without creating a Apple DocSet bundle, because we build a docset bundle only for release versions (process of docset bundle building is very long).

---

Library compilation with command line interface

For compiling a library by using a command line interface you can use the following command:

make -f Makefile <target>

Argument target specifies one of the following compilation targets:

• scl-osx - a framework for the operating system macOS (/Developer/Frameworks/MacOS/Release/scl.framework)
• libscl-osx - a static library for the operating system macOS (/Developer/Frameworks/MacOS/Release/libscl.a)
• libscl-ios - a static library for the operating system iOS (devices and simulators) (/Developer/Frameworks/iOS/libscl.a)
• doc - this documentation (/Developer/Documentation)
• src - a library source code (/Developer/Sources)

If you want build all specified targets, you can use the following command:

make -f Makefile apple

For compiling a library with the debug information you can use the following targets for a make command:

• scl-osx-debug - a debug framework for the operating system macOS (/Developer/Frameworks/MacOS/Debug/scl.framework)
• libscl-osx-debug - a debug static library for the operating system macOS (/Developer/Frameworks/MacOS/Debug/libscl.a)
• libscl-ios-debug - a debug static library for iOS devices (/Developer/Frameworks/iOS/Debug-iphoneos/libscl.a)
• libscl-ios-sim-debug - a debug static library for iOS simulators (/Developer/Frameworks/iOS/Debug-iphonesimulator/libscl.a)

For compiling all debug targets you can use the following command:

make -f Makefile apple-debug