В этой статье:

Подключение фреймворка FMPKit через фреймворк Flutter

Фреймворк iOS

Для разработки мобильного приложения используйте iOS-фреймворк FMPKit. FMPKit - объектно-ориентированный фреймворк, позволяющий разрабатывать мобильные приложения на базе сервера мобильной платформы, выстраивать архитектуру приложений на основе готовых конструкций и обмениваться данными с источником.

Фреймворк поставляется с документацией FMPKit, которая содержит подготовку и работу с фреймворком, а также описание его структуры:

классы;
перечисления;
протоколы;
структуры.

Для работы с фреймворком обратитесь к документации FMPKit по адресу:

https://help.fsight.ru/MobilePlatform/API/ios/documentation/fmpkit/

На боковой панели содержится навигация по элементам фреймворка, которые разделены на соответствующие разделы для работы с фреймворком.

Также для разработки мобильного приложения доступны фреймворки HHFW и FMPWrapper. Структура фреймворка FMPWrapper основана на базовом фреймворке HHFW. Фреймворк FMPWrapper используется только при подключённом фреймворке HHFW.

Примечание. Фреймворки HHFW и FMPWrapper являются устаревшими и используются для совместимости с прошлыми версиями «Форсайт. Мобильная платформа».

Для использования фреймворка подключите его к проекту разработки мобильного приложения. Ниже приведено описание подключения фреймворков в среде разработки Xcode.

Подключение фреймворка FMPKit через фреймворк Flutter

Для получения информации о подключении фреймворка FMPKit в проект разработки мобильного приложения обратитесь к документации FMPKit.

После подключения фреймворка подготовьте кроссплатформенное мобильное приложение к разработке через фреймворк Flutter:

Скачайте архив кроссплатформенного моста flutter-ios*.zip.

Примечание. Для получения готового кроссплатформенного моста обратитесь в техническую поддержку по адресу support@fsight.ru или через сервисы технической поддержки, которые доступны после регистрации на сайте.

Добавьте файл fmp_bridge.dart, содержащийся в папке lib, в кроссплатформенную часть проекта разработки мобильного приложения:

Добавьте содержимое папки FMPFlutter, расположенной в иерархии папок ios\Runner, в нативную часть проекта разработки мобильного приложения Runner.xcworkspace:

Выполните действия для настройки нативной части проекта Runner.xcworkspace:

создайте ссылку на объект FMPFlutter в файле AppDelegate.swift;
инициируйте объект FMPFlutter внутри метода application(_:didFinishLaunchingWithOptions:), используя механизм FlutterMethodChannel с заданным наименованием канала, например, «com.example.flutterApplication/FMPKit»;
установите обработчики вызовов с помощью метода setMethodCallHandler():

import UIKit

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
    var fmpFlutter: FMPFlutter!
    override func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        let controller : FlutterViewController = window?.rootViewController as! FlutterViewController

        // FMP Channel
        fmpFlutter = FMPFlutter(methodChannel: FlutterMethodChannel(
            name: "com.example.flutterApplication/FMPKit",
            binaryMessenger: controller.binaryMessenger)
        )
        fmpFlutter.setMethodCallHandler()

        GeneratedPluginRegistrant.register(with: self)
        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
    }
}

Откройте файл fmp_bridge.dart в кроссплатформенной части проекта разработки мобильного приложения и укажите наименование канала («com.example.flutterApplication/FMPKit»), заданное в шаге 3 для нативной части проекта, в статическом свойстве platform класса FMP:

import 'package:flutter/services.dart';
import 'dart:async';
 
class FMP {
static const platform = MethodChannel('com.example.flutterApplication/FMPKit');

Импортируйте fmp_bridge.dart в файл проекта разработки мобильного приложения:

import 'package:flutter_application/fmp_bridge.dart';

После выполнения действий будет подготовлено кроссплатформенное мобильное приложение к разработке с использованием свойств и методов фреймворка FMPKit. Пример построения объекта FMP:

try {
    final fmp = await FMP.build(
        url: 'https://url/',
        environment: 'environment',
        project: 'project',
        udid: 'deviceID'
    );
     
    print('fmpId: ${fmp.fmpID}');
 
} on PlatformException catch (error) {
    print('Failed to build FMP: ${error.message}');
}

Подключение фреймворка HHFW

Для подключения фреймворка HHFW к проекту разработки мобильного приложения:

Скачайте архив IOSFMP<версия релиза>.zip с файлом фреймворка HHFW и распакуйте его.

Примечание. Для получения архива фреймворка обратитесь в техническую поддержку по адресу support@fsight.ru или через сервисы технической поддержки, которые доступны после регистрации на сайте.

Добавьте файл HHFW.framework в проект одним из способов:

перетяните файл HHFW.framework из Finder в проект. После чего будет открыто окно «Choose options for adding these files». Установите флажок «Copy items if needed» и нажмите кнопку «Finish»:

выполните команду «Add Files to "<наименование проекта>"» в раскрывающемся меню кнопки , расположенной на нижней навигационной панели:

После чего будет открыто стандартное окно выбора файла. Выберите файл HHFW.framework, установите флажок «Copy items if needed» и нажмите кнопку «Add»:

После выполнения действий файл HHFW.framework будет добавлен в проект:

Измените настройки проекта:

установите значение «Embed Without Signing» для файла HHFW.framework в разделе «Настройки проекта > Настройки таргета > General > Frameworks, Libraries, and Embedded Content»:

установите значение «No» для «Enable Bitcode» в разделе «Настройки проекта > Настройки таргета > Build Settings > Build Options»:

Создайте в проекте связующий файл Bridging-Header.h автоматически или вручную для разработки на языке Swift. Фреймворк HHFW разработан на Objective-C.

Автоматическое создание файла

Создание файла вручную

Добавьте строку в файле <наименование проекта>-Bridging-Header.h для импорта HHFW.h:

После выполнения действий фреймворк HHFW будет подключен к проекту и методы фреймворка будут доступны для использования.

Для получения подробной информации о фреймворке HHFW обратитесь к разделу «Фреймворк HHFW».

Подключение фреймворка FMPWrapper

Для подключения фреймворка FMPWrapper к проекту разработки мобильного приложения:

Скачайте архив IOSFMP<версия релиза>.zip с файлом фреймворка FMPWrapper и распакуйте его.

Убедитесь, что к проекту подключён фреймворк HHFW.
Выполните шаги 1-3 для добавления файла FMPWrapper.framework. Файл фреймворка добавляется аналогично добавлению файла HHFW.framework.
Установите значение «Embed Without Signing» для файла FMPWrapper.framework в разделе «Настройки проекта > Настройки таргета > General > Frameworks, Libraries, and Embedded Content»:

Добавьте строку в файле с расширением *.swift для импорта FMPWrapper:

После выполнения действий фреймворк FMPWrapper будет подключен к проекту и методы фреймворка будут доступны для использования в файле *.swift.

Для получения подробной информации о фреймворке FMPWrapper обратитесь к разделу «Фреймворк FMPWrapper».