Добавление зависимостей iOS

Добавление библиотеки без CocoaPods

1. Скачайте исходный код библиотеки и поместите его куда-то, откуда вы сможете сослаться на него из своего проекта.

2. Скомпилируйте библиотеку (авторы библиотеки обычно предоставляют руководство по этому процессу) и получите путь к двоичным файлам.

3. В своём проекте создайте файл .def, например DateTools.def.

4. Добавьте первую строку в этот файл: language = Objective-C. Если вы хотите использовать чистую C-зависимость, опустите свойство языка.

5. Укажите значения для двух обязательных свойств:

   • headers описывает, какие заголовки будут обработаны cinterop.

   • package устанавливает имя пакета, в который должны быть помещены эти объявления.

   Например:

   headers = DateTools.h
   package = DateTools
   

6. Добавьте информацию о взаимодействии с этой библиотекой в скрипт сборки:

   • Укажите путь к файлу .def. Этот путь можно опустить, если ваш файл .def имеет такое же имя, как и cinterop, и расположен в каталоге src/nativeInterop/cinterop/.

   • Укажите cinterop, где искать заголовочные файлы, используя опцию includeDirs.

   • Настройте линковку с двоичными файлами библиотеки.

   kotlin {
       iosX64() {
           compilations.getByName("main") {
               val DateTools by cinterops.creating {
                   // Path to .def file
                   defFile("src/nativeInterop/cinterop/DateTools.def")
   
                   // Directories for header search (an analogue of the -I<path> compiler option)
                   includeDirs("include/this/directory", "path/to/another/directory")
               }
               val anotherInterop by cinterops.creating { /* ... */ }
           }
   
           binaries.all {
               // Linker options required to link to the library.
               linkerOpts("-L/path/to/library/binaries", "-lbinaryname")
           }
       }
   }
   

   kotlin {
       iosX64 {
           compilations.main {
               cinterops {
                   DateTools {
                       // Path to .def file
                       defFile("src/nativeInterop/cinterop/DateTools.def")
   
                       // Directories for header search (an analogue of the -I<path> compiler option)
                       includeDirs("include/this/directory", "path/to/another/directory")
                   }
                   anotherInterop { /* ... */ }
               }
           }
   
           binaries.all {
               // Linker options required to link to the library.
               linkerOpts "-L/path/to/library/binaries", "-lbinaryname"
           }
       }
   }
   

7. Соберите проект.

Теперь вы можете использовать эту зависимость в своём Kotlin-коде. Для этого импортируйте пакет, который вы настроите в свойстве package в файле .def . В данном примере это будет:

import DateTools.*

Добавление фреймворка без CocoaPods

1. Скачайте исходный код фреймворка и поместите его куда-то, откуда вы сможете сослаться на него из своего проекта.

2. Соберите фреймворк (авторы фреймворка обычно предоставляют руководство по этому процессу) и получите путь к двоичным файлам.

3. В своём проекте создайте файл .def , например MyFramework.def.

4. Добавьте первую строку в этот файл: language = Objective-C. Если вы хотите использовать чистую C-зависимость, опустите свойство языка.

5. Укажите значения для этих двух обязательных свойств:

   • modules – имя фреймворка, который должен быть обработан cinterop.

   • package – имя пакета, в который должны быть помещены эти объявления.

   Например:

   modules = MyFramework
   package = MyFramework
   

6. Добавьте информацию о взаимодействии с фреймворком в скрипт сборки:

   • Укажите путь к файлу .def. Этот путь можно опустить, если ваш файл .def имеет то же имя, что и cinterop, и находится в каталоге src/nativeInterop/cinterop/.

   • Передайте имя фреймворка компилятору и линковщику, используя опцию -framework . Передайте путь к исходным файлам и двоичным файлам фреймворка компилятору и линковщику, используя опцию -F.

   kotlin {
       iosX64() {
           compilations.getByName("main") {
               val DateTools by cinterops.creating {
                   // Path to .def file
                   defFile("src/nativeInterop/cinterop/DateTools.def")
   
                   compilerOpts("-framework", "MyFramework", "-F/path/to/framework/")
               }
               val anotherInterop by cinterops.creating { /* ... */ }
           }
   
           binaries.all {
               // Tell the linker where the framework is located.
               linkerOpts("-framework", "MyFramework", "-F/path/to/framework/")
           }
      }
   }
   

   kotlin {
       iosX64 {
           compilations.main {
               cinterops {
                   DateTools {
                       // Path to .def file
                       defFile("src/nativeInterop/cinterop/MyFramework.def")
   
                       compilerOpts("-framework", "MyFramework", "-F/path/to/framework/")
                   }
                   anotherInterop { /* ... */ }
               }
           }
   
           binaries.all {
               // Tell the linker where the framework is located.
               linkerOpts("-framework", "MyFramework", "-F/path/to/framework/")
           }
       }
   }
   

7. Соберите проект.

Теперь вы можете использовать эту зависимость в своём Kotlin-коде. Для этого импортируйте пакет, который вы настроите в свойстве пакета в файле .def. В данном примере это будет:

import MyFramework.*

Дополнительные сведения о взаимодействии Objective-C и Swift и настройке cinterop из Gradle.