Представление диалоговых окон уведомления

Для более простых форм уведомления APIs KUNC обеспечивает функцию, выводящую на экран диалоговое окно уведомления (KUNCNotificationDisplayNotice) и функция, выводящая на экран предупредительное диалоговое окно (KUNCNotificationDisplayAlert). Различие между уведомлением и предупреждением является прямым:

• Уведомление (рисунок 5-1) используется просто для информирования пользователя о некоторой ситуации, связанной с аппаратными средствами; потому что это не требует ответа от пользователя, код вызова не блокируется. Если тайм-аут используется, никакая кнопка, уведомление имеет только одну кнопку или. Нажатие кнопки просто отклоняет диалоговое окно.

• Предупреждение (рисунок 5-2) не только говорит пользователю о некотором событии, связанном с аппаратными средствами, но запрашивает пользователя сделать выбор среди двух или трех альтернатив, связанных с тем событием. Код, вызывая KUNC предупреждает функциональные блоки, пока пользователь не нажимает одну из кнопок для указания выбора; это тогда должно интерпретировать, какая кнопка была нажата и действие соответственно. Можно указать период тайм-аута, и если период истекает без пользователя, делающего выбор, KUNC закрывает диалоговое окно и возвращает действие по умолчанию (связанный с мигающей кнопкой).

KUNC noticeFigure 5-2

KUNCUserNotificationDisplayNotice и KUNCUserNotificationDisplayAlert функции имеют подобные подписи, список параметров последнего, являющийся надмножеством формирователя. Перечисление 5-1 показывает прототип для KUNCUserNotificationDisplayNotice.

  Определение перечисления 5-1 KUNCUserNotificationDisplayNotice

kern_return_t

KUNCUserNotificationDisplayNotice(

    int     timeout,

    unsigned    flags,

    char        *iconPath,

    char        *soundPath,

    char        *localizationPath,

    char        *alertHeader,

    char        *alertMessage,

    char        *defaultButtonTitle);

Таблица 5-1 описывает параметры этой функции.

KUNCUserNotificationDisplayAlert функция добавляет еще три параметра (Таблица 5-2).

Перечисление 5-2 иллюстрирует, как Вы могли бы вызвать KUNCUserNotificationDisplayAlert и (тривиально) интерпретируйте ответ. Если kern_return_t возвращаемое значение не KERN_SUCCESS, тогда вызов перестал работать по некоторым причинам; можно распечатать строку, описывающую причину с mach_error_string функция.

  Вызов перечисления 5-2 KUNCUserNotificationDisplayAlert

kern_return_t ret;

unsigned int rf;

ret = KUNCUserNotificationDisplayAlert(

    10,

    0,

    NULL,

    NULL,

    NULL,

    "Something's Gone Terribly Wrong!",

    "Do you want to do anything about it?",

    "Yes",  // Default

    "No", // Alternative

    "Think About It", // Other

    &rf);

    if (ret == KERN_SUCCESS) {

        if (rf == kKUNCDefaultResponse)

            IOLog("Default button clicked");

        else if (rf == kKUNCAlternateResponse)

            IOLog("Alternate button clicked");

        else if (rf == kKUNCOtherResponse)

            IOLog("Other button clicked");

    }

Запуск исполнимых программ пространства пользователя

Ваш код ядра может использовать Центр Уведомления Пользователя ядра для запуска приложений. Можно, таким образом, затронуть участие пользователя в сложной установке, конфигурации, и других задачах, связанных с драйвером или другом расширении ядра. Можно использовать KUNC не только, чтобы запустить приложения, но и представить предпочтительные области и выполнить демонов или другой (не-GUI) инструменты.

Функция KUNC, которую Вы вызываете для запуска приложения, KUNCExecute. Эта функция берет три параметра:

• Путь к исполнимой программе (executionPath). Путь файловой системы к приложению или другой исполнимой программе. Форма пути обозначена третьим параметром (pathExecutionType).

• Авторизация пользователя (openAsUser). Уровень авторизации пользователя, данный запущенное приложение. Это может быть любой как зарегистрированный пользователь (kOpenAppAsConsoleUser) или как корень (kOpenAppAsRoot). Задачи разрешений на доступ пользователя root, такие как копирование к /System/Library без потребности аутентифицировать; необходимо использовать доступ пользователя root рассудительно.

• Тип исполнимого пути (pathExecutionType). Форма исполнимого пути, указанного в первом параметре (executionPath). Параметр должен быть одной из следующих констант:

  Постоянный	Описание
  kOpenApplicationPath	Абсолютный путь к исполнимой программе. Для приложения это - двоичный файл в комплекте приложений MacOS каталог (например, /Applications/Foo.app/Contents/MacOS/Foo).
  kOpenPreferencePanel	Имя предпочтения разделяет на области в /System/Library/PreferencePanes (например, ColorSync.prefPane).
  kOpenApplication	Имя приложения (минус.app) в любом из системных расположений для приложений: /Applications, /Network/Applications, или ~/Applications.

Код, показанный в Перечислении 5-3, запускает текстовое приложение Редактирования и открывает интернет-предпочтительную область.

Перечисление 5-3  , Запускающее приложения от KEXT

kern_return_t ret;

ret = KUNCExecute("/Applications/TextEdit.app/Contents/MacOS/TextEdit", kOpenAppAsRoot, kOpenApplicationPath);

ret = KUNCExecute("Internet.prefPane", kOpenAppAsConsoleUser, kOpenPreferencePanel);

Это обычно - хорошая идея поднять уведомление (функция KUNCUserNotificationDisplayNotice) одновременно Вы запускаете приложение или открываете предпочтительную область для информирования пользователей, что они должны сделать с предпочтительной областью или приложением.

Представление связанных диалоговых окон

Диалоговые окна, создаваемые через KUNCUserNotificationDisplayNotice и KUNCUserNotificationDisplayAlert функции имеют ограниченный набор элементов пользовательского интерфейса для представления пользователям. Кроме заголовка, значка и сообщения, они разрешают до трех кнопок, и вот именно. Единственной информацией, которую они могут выявить, является выбор, сделанный через щелчок кнопки.

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

• Заголовок, текст сообщения, звук и значок

• До трех кнопок (значение по умолчанию, альтернатива, другой)

• Текстовые поля, включая поля пароля

• Раскрывающиеся списки

• Флажки

• Переключатели

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

Средства управления и поведение этих диалоговых окон уведомления пользователя ядра получены как XML-описания, сохраненные в файле в пакете (обычно сам пакет KEXT). На основании того, чтобы быть связанным XML-описания локализуемы. Можно также обновить их без потребности в том, чтобы перекомпилировать. XML-файл можно назвать чем-либо. Это состоит из произвольного числа элементов словаря, один каждый для диалогового окна, которое могло бы представить расширение ядра. Каждое диалоговое описание само является словарем, ключи которого могут быть любым из описанных в Таблице 5-3.

Как обозначено в описании Localization URL свойство выше, можно получить доступ к локализованному тексту двумя способами. У Вас могут быть локализованные версии самого файла XML-описания. Или у Вас могут быть единственный файл XML-описания и a Localizable.strings файл для каждой локализации. В последнем случае, Localization URL свойство указывает на пакет, содержащий Localizable.strings файлы и значения текстовых свойств в файле XML-описания являются ключами в Localizable.strings.

Желанный аспект функции связанных уведомлений KUNC - то, что это является асинхронным. Когда Вы вызываете KUNCUserNotificationDisplayFromBundle функционируйте для запроса диалогового окна, вызов сразу возвращается. Ваш код может продолжить делать другие вещи. KUNC обрабатывает поставку запроса к пространству пользователя, где диалоговое окно создано и выведено на экран. В течение его поездки запрос идентифицируется уведомлением ID, к которому Вы предоставили KUNCUserNotificationDisplayFromBundle. Когда пользователь нажимает одну из диалоговых кнопок, функция обратного вызова, реализованная в Вашем KEXT, вызывается. Там можно идентифицировать запрос через его уведомление ID и обработать ответ пользователя.

Перечисление 5-4 показывает подпись KUNCUserNotificationDisplayFromBundle функция.

  Объявление перечисления 5-4 KUNCUserNotificationDisplayFromBundle

kern_return_t

KUNCUserNotificationDisplayFromBundle(

    KUNCUserNotificationID      notificationID,

    char                        *bundleIdentifier,

    char                        *fileName,

    char                        *fileExtension,

    char                        *messageKey,

    char                        *tokenString,

    KUNCUserNotificationCallBackcallback,

    int                         contextKey);

Таблица 5-4 описывает параметры этой функции.

Последний шаг в реализации связанных уведомлений для Вашего расширения ядра должен реализовать функцию обратного вызова для обработки пользовательских ответов. Эта функция должна соответствовать KUNCUserNotificationCallback прототип:

typedef void (*KUNCUserNotificationCallBack)(

    int     contextKey,

    int     responseFlags,

    void    *xmlData);

Несколько параметров могут казаться знакомыми. contextKey параметр является тем же значением, которое Вы передали в KUNCUserNotificationDisplayFromBundle функционируйте, чтобы помочь идентифицировать запрос. responseFlags параметр содержит одну из констант, идентифицирующих диалоговую кнопку, которую нажал пользователь; эти константы обсуждены inPresenting Диалоговые окна Уведомления. То, что является новым, является xmlData параметром. Это - строковые данные XML, связанные с ответом пользователя; если пользователь ввел информацию (такую как имя пользователя и пароль) или выбрал раскрывающийся элемент, переключатель или флажок, Ваш код должен проанализировать XML и извлечь эту информацию.

При парсинге XML необходимо искать соответствующий элемент массива, который Вы передали в KUNC. Например, если у Вас есть поле имени пользователя и поле пароля, у Вас есть a Text Field Strings массив с двумя элементами. Когда Вы анализируете xmlData параметр, первый элемент Text Field Strings имя пользователя, вводимое пользователем; второй элемент является паролем. Точно так же Вы анализируете Selected Popup массив для наблюдения, какой индекс в тот массив был выбран.

Чтобы проиллюстрировать, как Вы могли бы использовать APIs KUNC для связанных диалоговых окон уведомления, давайте продвинемся через несколько примеров. Вы создаете вызванный XML-файл Messages.dict и помещенный это в Ваш локализованный KEXT’s .lprojкаталоги. Этот файл содержит ключ «Password Message»; Перечисление 5-5 показывает связанное XML-описание для этого ключа.

  XML-описание перечисления 5-5 диалогового окна пароля

    <key>Password Message</key>

    <dict>

        <key>Alternate Button Title</key>

        <string>Cancel</string>

        <key>OK Button Title</key>

        <string>OK</string>

        <key>Header</key>

        <string>Authentication Message</string>

        <key>Message</key>

        <string>Please enter a user name and password.</string>

        <key>Timeout</key>

        <string>0</string>

        <key>Alert Level</key>

        <string>Stop</string>

        <key>Text Field Strings</key>

        <array>

            <string>User Name:</string>

            <string>Password:</string>

        </array>

        <key>Password Fields</key>

        <array>

            <string>1</string>

        </array>

        <key>Blocking Message</key>

        <string>1</string>

    </dict>

В коде Вашего расширения ядра Вы вызываете KUNCUserNotificationDisplayFromBundle, указание “Пароля обменивается сообщениями” как клавиша сообщения (Перечисление 5-6).

Перечисление 5-6  , Выводящее на экран связанное диалоговое окно пароля

context = 2;

ret = KUNCUserNotificationDisplayFromBundle(KUNCGetNotificationID(),

    "/tmp/ExampleDriver/ExampleDriver.kext",

    "Messages",

    "dict",

    "Password Message",

    "",

    MyKUNCBundleCallback,

    context);

Когда этот код выполняется, диалоговое окно, показанное в Перечислении 5-6, появляется на экране пользователя, как на рисунке 5-3.

Конечно, у Вас могут быть еще более сложные диалоговые окна с соединением элементов пользовательского интерфейса. Перечисление 5-7 показывает XML-описание диалогового окна, включающего текст и поля пароля и переключатели.

  XML-описание перечисления 5-7 диалогового окна с различными средствами управления

    <key>Mixed Message</key>

    <dict>

        <key>OK Button Title</key>

        <string>OK</string>

        <key>Header</key>

        <string>Authorization</string>

        <key>Message</key>

        <string>Please log in at required level.</string>

        <key>Timeout</key>

        <string>20</string>

        <key>Alert Level</key>

        <string>Stop</string>

        <key>Text Field Strings</key>

        <array>

            <string>User Name:</string>

            <string>Password:</string>

        </array>

        <key>Password Fields</key>

        <array>

            <string>1</string>

        </array>

        <key>Radio Button Strings</key>

        <array>

            <string>User</string>

            <string>Local Admin</string>

            <string>Network Admin</string>

        </array>

        <key>Selected Radio</key>

        <string>1</string>

    </dict>

Когда Ваше загруженное расширение ядра вызывает KUNCUserNotificationDisplayFromBundle функция, предоставление на сей раз “Смешанное сообщение” как ключ словаря XML, диалоговое окно, показанное на рисунке 5-4, появляется на экране пользователя.