Сбой сборки модуля Titanium iOS с предупреждениями симулятора несмотря на цель физического устройства

Сбой сборки, с которым вы сталкиваетесь, происходит потому, что ваш модуль Titanium iOS пытается собрать для симуляторов, хотя вы указали зависимости только для устройств. Даже если вы ориентируетесь на физическое устройство, процесс сборки все равно ссылается на срезы симулятора, которые отсутствуют в ваших зависимостях. Это несоответствие вызывает сбой сборки.

Содержание

• Понимание основной проблемы
• Нужно ли подключать физическое устройство?
• Почему Titanium ссылается на срезы симулятора
• Решение проблемы со сборкой
• Лучшие практики для зависимостей модуля
• Чек-лист для устранения неполадок

Понимание основной проблемы

При сборке модуля Titanium iOS с внешними зависимостями, такими как .xcframeworks или Swift Packages, процесс сборки должен генерировать срезы как для симуляторов, так и для физических устройств. Ваше сообщение об ошибке указывает, что:

1. Titanium обнаруживает несколько целей сборки (и симуляторы, и устройства)
2. По умолчанию он выбирает цель симулятора первой, как показано в предупреждении: “Используется первый из нескольких совпадающих целей”
3. Ваши зависимости содержат только срезы для устройств (как указано в “Примечания поставщика SDK: не предоставлены срезы симулятора”)
4. Это несоответствие архитектур вызывает сбой сборки

Ключевое понимание заключается в том, что даже когда вы указываете флаг --build-only и намерены нацелиться на физическое устройство, система сборки Titanium все равно оценивает все доступные цели, включая симуляторы.

Нужно ли подключать физическое устройство?

Для сборки модуля Titanium с флагом --build-only не требуется подключать физическое устройство. Флаг --build-only явно указывает Titanium:

• Генерировать пакет модуля (.zip файл)
• Не устанавливать его на устройство или симулятор
• Сконцентрироваться на процессе компиляции и линковки

Однако проблема не связана с подключением устройства — она заключается в совместимости архитектур. Titanium должен знать, для каких архитектур собирать, и когда зависимости предоставляют только срезы для устройств, процесс сборки должен по умолчанию использовать сборку только для устройств.

Почему Titanium ссылается на срезы симулятора

Titanium ссылается на срезы симулятора по нескольким причинам:

1. Рабочий процесс разработки: Конфигурация сборки Titanium по умолчанию часто включает симуляторы для тестирования целей во время разработки.

2. Отсутствие конфигурации только для устройств: Когда не установлена явная конфигурация только для устройств, Titanium возвращается к оценке всех доступных целей сборки.

3. Архитектура зависимостей: Ваши .xcframeworks или пакеты могут быть настроены таким образом, что они должным образом не сообщают о своей ориентации только на устройства системе сборки.

4. Система сборки Titanium: CLI Titanium может по умолчанию использовать “общую” сборку, которая проверяет все доступные цели перед определением подходящей архитектуры.

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

Процесс сборки Titanium
                      |
                      v
Определение доступных целей
                      |
                      v
[Симуляторы] [Устройства]
      |           |
      v           v
Проверка зависимостей   Проверка зависимостей
на наличие срезов       на наличие срезов
      |           |
      v           v
Сбой (нет срезов) Успех (срезы устройства)

Решение проблемы со сборкой

Решение 1: Явное указание сборки только для устройств

Измените команду сборки, чтобы явно указать цель устройства:

ti build -p ios --build-only --target-device iphone

Это указывает Titanium рассматривать только сборки для устройств и игнорировать симуляторы.

Решение 2: Правильная настройка зависимостей

Для .xcframeworks убедитесь, что они содержат правильные срезы архитектур. Если вы создаете свой собственный .xcframework:

# Создание фреймворка для устройства
xcodebuild -project YourProject.xcodeproj -scheme YourScheme -configuration Release -sdk iphoneos -arch arm64 -archivePath YourProject.xcarchive archive

# Создание фреймворка для симулятора
xcodebuild -project YourProject.xcodeproj -scheme YourScheme -configuration Release -sdk iphonesimulator -arch x86_64 -archivePath YourProject-sim.xcarchive archive

# Объединение в универсальный xcframework
xcodebuild -create-xcframework -framework YourProject.xcarchive/Products/Library/Frameworks/YourProject.framework -framework YourProject-sim.xcarchive/Products/Library/Frameworks/YourProject.framework -output YourProject.xcframework

Решение 3: Изменение конфигурации модуля

Обновите файл module.xcconfig вашего модуля, чтобы явно указать архитектуры только для устройств:

// module.xcconfig
ONLY_ACTIVE_ARCH = NO
VALID_ARCHS = arm64 arm64e
ARCHS = arm64 arm64e

Решение 4: Обновление скрипта сборки в вашем модуле

В файле build.py вашего модуля Titanium измените скрипт сборки, чтобы явно установить конфигурацию только для устройств:

def build(titaniumSdk):
    import os
    import subprocess
    
    # Получение пути к xcodeproj
    xcodeproj_path = os.path.join(os.getcwd(), "YourModule.xcodeproj")
    
    # Сборка только для устройства
    cmd = ["xcodebuild", "-project", xcodeproj_path, "-scheme", "YourModule", "-configuration", "Release", "-sdk", "iphoneos", "archive"]
    
    # Выполнение команды
    subprocess.call(cmd)

Решение 5: Проверка и обновление зависимостей пакетов

Для зависимостей Swift Package убедитесь, что они правильно настроены для включения архитектур устройств. В Xcode:

1. Выберите ваш проект в навигаторе проектов
2. Перейдите к “Frameworks, Libraries, and Embedded Content” для вашей цели
3. Убедитесь, что зависимости пакетов установлены на “Embed & Sign”
4. Проверьте раздел “Platforms”, чтобы убедиться, что выбран iOS с соответствующими архитектурами

Лучшие практики для зависимостей модуля

1. Универсальные фреймворки

Всегда создавайте универсальные .xcframeworks, которые включают:

• Срезы устройств (arm64, arm64e)
• Срезы симуляторов (x86_64, arm64 для Mac на базе Apple Silicon)

2. Условный код

Используйте условную компиляцию для разделения кода для симулятора и устройства:

#if targetEnvironment(simulator)
    // Код, специфичный для симулятора
#else
    // Код, специфичный для устройства
#endif

3. Проверка архитектуры

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

import Foundation

public class ArchitectureValidator {
    public static func validate() {
        #if targetEnvironment(simulator)
            print("Запущено на симуляторе")
        #else
            print("Запущено на устройстве")
        #endif
    }
}

4. Правильное управление зависимостями

Используйте инструмент управления зависимостями, такой как Swift Package Manager или CocoaPods, для правильной обработки сторонних библиотек.

5. Лучшие практики для скриптов сборки

При создании модулей Titanium всегда:

1. Явно указывайте архитектуры
2. Используйте правильные цели SDK
3. Обрабатывайте конфигурации как для симулятора, так и для устройства
4. Включайте обработку ошибок в скриптах сборки

Чек-лист для устранения неполадок

Перед попыткой сборки вашего модуля проверьте эти пункты:

• [ ] Ваши .xcframeworks содержат срезы как для симулятора, так и для устройства
• [ ] Ваши Swift Packages правильно настроены для iOS
• [ ] Файл module.xcconfig вашего модуля указывает правильные архитектуры
• [ ] Вы используете последние совместимые версии Titanium SDK и Xcode
• [ ] Ваш скрипт сборки явно нацелен на сборку только для устройств
• [ ] Все зависимости правильно связаны с целью вашего модуля
• [ ] Вы пробовали собирать с флагом --target-device iphone

Заключение

Сбой сборки модуля Titanium iOS с предупреждениями симулятора происходит потому, что процесс сборки пытается включить срезы симулятора, когда ваши зависимости предоставляют только срезы для устройств. Для решения этой проблемы:

1. Явно укажите сборку только для устройств с помощью флага --target-device iphone
2. Убедитесь, что ваши зависимости содержат правильные срезы архитектур
3. Настройте параметры сборки вашего модуля для архитектур только для устройств
4. Рассмотрите возможность создания универсальных фреймворков, включающих как срезы симулятора, так и устройства

Следуя этим шагам, вы должны успешно собирать ваш модуль Titanium iOS с внешними зависимостями, даже при нацеливании на физические устройства. Помните, что правильная настройка архитектур имеет решающее значение при работе с фреймворками и пакетами в модулях Titanium.