Преобразование вашего Android-приложения для работы на iOS – учебник

Определите, какой код сделать кроссплатформенным

Определите, какой код вашего Android-приложения лучше всего использовать совместно для iOS, а какой оставить нативным. Простое правило: используйте то, что вы хотите повторно использовать как можно чаще. Бизнес-логика часто одинакова как для Android, так и для iOS, поэтому она отлично подходит для повторного использования.

В вашем примере Android-приложения бизнес-логика хранится в пакете com.jetbrains.simplelogin.androidapp.data. Ваше будущее приложение для iOS будет использовать ту же логику, поэтому вам также следует сделать её кроссплатформенной.

Создайте общий модуль для кроссплатформенного кода

Кроссплатформенный код, используемый как для iOS, так и для Android, хранится в общем модуле. Kotlin Multiplatform предоставляет специальный мастер для создания таких модулей.

В вашем Android-проекте создайте общий модуль Kotlin Multiplatform для вашего кроссплатформенного кода. Позже вы подключите его к вашему существующему Android-приложению и вашему будущему приложению для iOS.

1. В Android Studio нажмите Файл | Создать | Новый модуль.

2. В списке шаблонов выберите Kotlin Multiplatform Shared Module, введите имя модуля shared, и выберите Regular framework в списке параметров распространения фреймворка iOS.
   Это необходимо для подключения общего модуля к приложению iOS.

   

3. Нажмите Готово.

Мастер создаст общий модуль Kotlin Multiplatform, обновит файлы конфигурации и создаст файлы с классами, демонстрирующими преимущества Kotlin Multiplatform. Вы можете узнать больше о структуре проекта.

Добавьте зависимость от общего модуля к вашему Android-приложению

Чтобы использовать кроссплатформенный код в вашем Android-приложении, подключите к нему общий модуль, переместите туда код бизнес-логики и сделайте этот код кроссплатформенным.

1. Убедитесь, что compileSdkVersion и minSdkVersion в build.gradle.kts модуля shared совпадают с теми, которые находятся в build.gradle вашего Android-приложения в модуле app.
   Если они отличаются, обновите их в build.gradle.kts общего модуля. В противном случае вы столкнетесь с ошибкой компиляции.

2. Добавьте зависимость от общего модуля к build.gradle вашего Android-приложения.

   dependencies {
       implementation project(':shared')
   }
   

3. Синхронизируйте файлы Gradle, нажав Синхронизировать сейчас в предупреждении.

   

4. Чтобы убедиться, что общий модуль успешно подключен к вашему приложению, выведите результат функции greeting() в лог, обновив метод onCreate() класса LoginActivity.

   override fun onCreate(savedInstanceState: Bundle?) {
      super.onCreate(savedInstanceState)
   
      Log.i("Login Activity", "Hello from shared module: " + (Greeting().greeting()))
   
   }
   

5. Найдите Hello в логе, и вы найдете приветствие из общего модуля.

   

Сделайте бизнес-логику кроссплатформенной

Теперь вы можете извлечь код бизнес-логики в общий модуль Kotlin Multiplatform и сделать его независимым от платформы. Это необходимо для повторного использования кода как для Android, так и для iOS.

1. Переместите код бизнес-логики com.jetbrains.simplelogin.androidapp.data из директории app в пакет com.jetbrains.simplelogin.shared в директории shared/src/commonMain. Вы можете перетащить пакет или рефакторить его, перемещая все из одной директории в другую.

   

2. Когда Android Studio спросит, что вы хотите сделать, выберите переместить пакет, а затем подтвердите рефакторинг.

   

3. Проигнорируйте все предупреждения о коде, зависящем от платформы, и нажмите Продолжить.

   

4. Удалите специфичный для Android код, заменив его кроссплатформенным кодом Kotlin или подключившись к специфичным для Android API, используя expect и actual объявления. См. следующие разделы для подробностей.

val fakeUser = LoggedInUser(java.util.UUID.randomUUID().toString(), "Jane Doe")

Запустите ваше кроссплатформенное приложение на Android

Запустите ваше кроссплатформенное приложение для Android, чтобы убедиться, что оно работает.

Создание проекта iOS в Xcode

1. В Xcode, нажмите Файл | Новый | Проект.

2. Выберите шаблон приложения iOS и нажмите Далее.

   

3. В качестве имени продукта укажите simpleLoginIOS и нажмите Далее.

   

4. В качестве расположения проекта выберите каталог, который хранит ваше кроссплатформенное приложение, например, multiplatform-integrate-into-existing-app.

В Android Studio вы получите следующую структуру:

Для согласованности с другими директориями верхнего уровня вашего кроссплатформенного проекта вы можете переименовать директорию simpleLoginIOS в iosApp.

Подключение фреймворка к проекту iOS

После получения фреймворка вы можете подключить его к вашему проекту iOS вручную.

Подключите фреймворк к проекту iOS вручную:

1. В Xcode откройте настройки проекта iOS, дважды щелкнув имя проекта.

2. На вкладке Этапы сборки настроек проекта нажмите + и добавьте Новый этап выполнения скрипта.

   

3. Добавьте следующий скрипт:

   cd "$SRCROOT/.."
   ./gradlew :shared:embedAndSignAppleFrameworkForXcode
   

   

4. Переместите этап Выполнение скрипта перед этапом Компиляция исходного кода.

   

5. На вкладке Настройки сборки укажите Путь поиска фреймворков в разделе Пути поиска:

   $(SRCROOT)/../shared/build/xcode-frameworks/$(CONFIGURATION)/$(SDK_NAME)
   

   

6. На вкладке Настройки сборки укажите Другие флаги компоновщика в разделе Компоновка:

   $(inherited) -framework shared
   

   

7. Соберите проект в Xcode. При правильной настройке проект будет успешно собран.

Использование общего модуля из Swift

1. В Xcode откройте файл ContentView.swift и импортируйте модуль shared.

   import shared
   

2. Чтобы проверить правильность подключения, используйте функцию greeting() из модуля Kotlin Multiplatform:

   import SwiftUI
   import shared
   
   struct ContentView: View {
       var body: some View {
           Text(Greeting().greeting())
           .padding()
       }   
   }
   

   

3. В ContentView.swift, напишите код для использования данных из модуля Kotlin Multiplatform и отрисовки пользовательского интерфейса приложения.

4. В simpleLoginIOSApp.swift, импортируйте модуль shared и укажите аргументы для функции ContentView().

   import SwiftUI
   import shared
   
   @main
   struct SimpleLoginIOSApp: App {
       var body: some Scene {
           WindowGroup {
               ContentView(viewModel: .init(loginRepository: LoginRepository(dataSource: LoginDataSource()), loginValidator: LoginDataValidator()))
           }
       }
   }