Инструкции по установке и компиляции

Оглавление

• Установка библиотеки из дистрибутива
• Сборка библиотеки из исходных кодов
  • Компиляция библиотеки с использованием Xcode
  • Компиляция библиотеки с помощью командной строки

Библиотека Samond Classes Library доступна как в скомпилированном виде, так и в виде исходных кодов:

• Установка библиотеки из дистрибутива
• Сборка библиотеки из исходных кодов

Инструкции по использованию библиотеки Вы можете найти в разделе Руководство по использованию.
Подробное описание классов и решений Вы найдете в разделе Руководство программиста.

Если у Вас есть вопросы по использованию библиотеки или возникли проблемы в ходе ее компиляции, Вы всегда можете связаться со мной по адресу samon.nosp@m.d@ma.nosp@m.c.com.

---

Установка библиотеки из дистрибутива

Установка из дистрибутива возможна только для операционной системы macOS (и для сборки приложений для операционной системы iOS).

Дистрибутив представляет собой дисковый образ, содержащий следующие файлы и папки:

• Documentation - данная документация в формате Apple DocSet на русском и английском языках
• Include/scl - заголовочные файлы библиотеки
• Frameworks - скомпилированные файлы библиотеки для операционных систем macOS и iOS в соответствующих подкаталогах
• Sources - исходные коды библиотеки для всех поддерживаемых платформ

Для установки библиотеки из дистрибутива необходимо выполнить следующие действия:

• загрузить дистрибутив с нашего официального сайта
• смонтировать загруженный файл с помощью Finder
• скопировать содержимое дистрибутива в папку Developer (если каталог отсутствует, его необходимо создать, если какие-либо подкаталоги существуют, нужно скопировать содержимое подкаталогов дистрибутива в соответствующие папки каталога /Developer)

Установка в папку, отличную от /Developer, допускается но мы не рекомендуем этого делать, поскольку данный каталог используется как путь по умолчанию при сборке проекта в Xcode.

---

Сборка библиотеки из исходных кодов

Сборка библиотеки возможна как для операционных систем macOS и iOS, так и для платформы GNUstep. В данном разделе мы приводим описание сборки библиотеки только для macOS. Компиляция и установка для платформы GNUstep приведена в соответствующем разделе документации.

Получить исходные коды Вы можете:

• из папки Sources дистрибутива библиотеки
• загружены с нашего официального сайта
• получены через систему контроля версий с помощью одной из команд:

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

Скомпилировать библиотеку (или ее отдельные компоненты) можно одним из следующих способов:

• Компиляция библиотеки с использованием Xcode
• Компиляция библиотеки с помощью командной строки

По умолчанию скомпилированная библиотека устанавливается в каталог /Developer. Чтобы изменить данный путь, необходимо внести исправления в настройки соответствующего проекта с помощью Xcode. Также через настройки проектов можно изменить минимальную версию macOS или iOS, под которую будет выполняться сборка библиотеки.

---

Компиляция библиотеки с использованием Xcode

Загрузите в Xcode проект sclmac.xcodeproj и с помощью комбинации клавиш Command + B или через меню Product->Build выполните сборку одного из проектов:

• libscl-ios - библиотеке для устройств под управлением операционной системы iOS (/Developer/Frameworks/iOS/Release-iphoneos/libscl.a)
• libscl-uni - универсальная библиотека для операционной системы iOS (устройства и симуляторы) (/Developer/Frameworks/iOS/libscl.a)
• libscl-osx - статическая библиотека для операционной системы macOS (/Developer/Frameworks/MacOS/Release/libscl.a)
• scl-osx - фреймворк для операционной системы macOS (/Developer/Frameworks/MacOS/Release/scl.framework)
• Documentation - данная документация (/Developer/Documentation)

Внимание! Если Вы загрузили исходные коды с помощью subversion, возможно, что не будет выполнена сборка документации в формате Apple DocSet, а только сборка документации в HTML. Это связано с тем, что сборка DocSet идет очень долго, что очень неудобно во время работы над библиотекой, поэтому сборка DocSet включается нами только перед выпуском релизным версий.

---

Компиляция библиотеки с помощью командной строки

Компиляция библиотеки через интерфейс командной строки осуществляется с использованием утилиты make, для вызова которой необходимо ввести команду:

make -f Makefile <target>

Параметр target задает одну из доступных целей сборки библиотеки:

• scl-osx - фреймворк для операционной системы macOS (/Developer/Frameworks/MacOS/Release/scl.framework)
• libscl-osx - статическая библиотека для операционной системы macOS (/Developer/Frameworks/MacOS/Release/libscl.a)
• libscl-ios - статическая библиотека для операционной системы iOS (устройства и симуляторы) (/Developer/Frameworks/iOS/libscl.a)
• doc - данная документация (/Developer/Documentation)
• src - исходные коды библиотеки (/Developer/Sources)

Для сборки всех вышеуказанных целей сразу можно использовать команду:

make -f Makefile apple

Если Вам необходимы библиотеки с поддержкой отладочной информации, то их можно собрать с помощью одной из следующих целей команды make:

• scl-osx-debug - отладочный фреймворк для операционной системы macOS (/Developer/Frameworks/MacOS/Debug/scl.framework)
• libscl-osx-debug - отладочная статическая библиотека для операционной системы macOS (/Developer/Frameworks/MacOS/Debug/libscl.a)
• libscl-ios-debug - отладочная статическая библиотека для операционной системы iOS (устройства) (/Developer/Frameworks/iOS/Debug-iphoneos/libscl.a)
• libscl-ios-sim-debug - отладочная статическая библиотека для операционной системы iOS (симуляторы) (/Developer/Frameworks/iOS/Debug-iphonesimulator/libscl.a)

Чтобы собрать все отладочные версии библиотеки, можно использовать команду:

make -f Makefile apple-debug