Як налаштувати опцію меню "Довідка" для програми iPad, що переноситься на Mac за допомогою Mac Catalyst?

За замовчуванням Mac Catalyst створює меню під назвою "Довідка", яке повинно містити допомогу для програми. Однак я не знайшов жодної документації щодо впровадження довідки. Для стандартних додатків для Mac можна використовувати довідкову книгу. Однак не згадується про те, як використовувати довідкову книгу з Mac Catalyst. Я намагався додати HelpBookDirectoryName до info.plist, але це не спрацювало. Чи є спосіб, щоб довідкові книги працювали з Mac Catalyst?

ios macos maccatalyst

— Кен Ро
джерело

Відповіді:

Ми використовуємо веб-довідкову систему для свого додатка iOS, і додавши її до відповідних UIViewControllers, здається, працює для підключення команди меню довідки для нашої версії Catalyst:

    // Show some help.
@IBAction func showHelp(_ sender: Any) {
    UIApplication.shared.open(URL(string: "http://www.ourapp.com/faq")!)
}

// Return whether action can be performed.
override func canPerformAction(_ action: Selector, withSender sender: Any?) -> Bool {

    if action == #selector(self.showHelp(_:)) {
        return true
    } else {
        return super.canPerformAction(action, withSender: sender)
    }
}

— ЛенК
джерело

Чи є інший спосіб? Apple раптом вирішила відмовити в моєму додатку, поки я не застосую меню довідки.

— sabiland

@sabiland Дивіться мою відповідь нижче. У мене були ті самі проблеми з відхиленням програми досі.

— Пол Мартін

Чудово @PaulMartin Я спробую.

— sabiland

FYI, ви можете помістити це в AppDelegateклас для тих, хто використовує SwiftUI.

— stardust4891

Гаразд ... Мені вдалося змусити це працювати, використовуючи сторонній додаток (Help Crafter) для створення MyAppName.helpфайлу / папки, але ви могли це зробити вручну.

Після створення MyAppName.helpфайлу вам потрібно скопіювати його в папку " Ресурси" свого проекту. Я зробив це спочатку, скопіювавши файл у папку «Ресурси» у Finder, а потім перетягнув цей файл у папку «Ресурси» у Xcode.

Найважливіший крок: Під час перетягування його у проект виберіть «Створити посилання на папки».

Раніше я вибрав "Створити групи", і це ніколи не працювало.

Це посилання також містить корисну інформацію, особливо якщо ви збираєтеся створити файл MyAppName.help вручну

http://swiftrien.blogspot.com/2015/06/adding-apple-help-to-os-x-application.html

Коротше кажучи, .plistвсередині MyAppName.helpфайлу / папки буде файл, але до .plistфайла ваших проектів потрібно також додати два ключі :

Help Book directory name-> ім'я вашого .helpфайлу (технічно це каталог з .helpрозширенням)
Help Book identifier-> для мене це було, maccatalyst.com.nitramluap.MyAppName.helpале він повинен бути однаковим ідентифікатором у MyAppName.help .plistклавішіBundle Identifier

— Пол Мартін
джерело