Значки для Windows Mobile 6.5

Для Windows Mobile 6.5 были написаны новые требования к значкам в формате PNG для стартового экрана. Если раньше приложение должно было содержать три значка разного размера, то теперь требуется только один значок в формате PNG размером 90x90 пикселей. Рассмотрим эти требования поближе.

Наверное, вы уже обратили внимание на измененный внешний вид начального экрана Сегодня, которая содержит более красивые значки, чем в предыдущих версиях. Это произошло из-за добавленной на стартовый экран Window Mobile 6.5 поддержке PNG-файлов. Формат PNG обеспечивает сжатие изображения без потери качества, и использование в приложении PNG-значка в этом формате гарантирует, что пользователи разных устройств будут будут видеть красивый значок без искажений.

Если вы планируете распространять свое приложение через Windows Marketplace for Mobile, то вам следует ознакомиться с документацией по требованиям к размещению. В соответствии с этими требованиями размер значка для стартового экрана должен быть 90х90 пикселей.

Стартовый экран: разрешение экрана, DPI и размер значка

Одно из самых существенных усовершенствований, сделанных в Windows Mobile 6.5 Professional – это стартовый экран, который заменил меню «Пуск» из прошлых версий. На стартовом экране расширены возможности навигации – поддерживается не только управлением пером, но и и при помощи пальцев в соответствии с современными веяниями (гонка за модным iPhone).

Как известно, в зависимости от разрешения экрана и количества точек на дюйм (DPI) на конкретном устройстве система извлекает из EXE-файла значок наиболее подходящего размера и показывает его на стартовом экране. В Windows Mobile версии 6.5 по-прежнему поддерживается эта функциональность, однако сейчас добавлена поддержка значков в формате PNG. Система не подбирает размер PNG-файла автоматически с учетом DPI устройства, вместо этого установочная DLL выбирает значок динамически (подробности описаны чуть ниже). Если же вы не хотите создавать для каждого разрешения отдельный PNG-файл, можно сделать всего один значок размером 90 x 90 пикселей, и оболочка уменьшит значок до нужного размера в зависимости от DPI устройства. В таблице ниже показано, как размер иконок зависит от разрешения экрана и DPI устройства.

Ключи реестра

Чтобы указать, что на стартовом экране нужно использовать PNG-файл, а не значок из EXE-файла, в реестре необходимо прописать следующее:

[HKEY_LOCAL_MACHINE\Security\Shell\StartInfo\Start\Phone.lnk]

"Icon"="\Application Data\My App\newphoneicon.png"
    

Ниже приведен список параметров элемента стартового экрана:

Статическая установка

Ключ реестра может быть задан как часть конфигурации CAB-файла. Например, добавим  вот такой ключ реестра в свой проект Smart Device CAB:

CAB-файл так же содержит значок AppIcon.png размером 90x90 пикселей и ярлык, имя которого совпадает с именем ключа реестра, описанного выше (SMS Intercept.lnk).

Динамическая установка

Второй способ – сконфигурировать значок для стартового экрана динамически, в процессе установки приложения, т.е. скопировать на устройство PNG-файл, размер которого соответствует DPI этого устройства. Для определения DPI устройства и копирования файла мы будем использовать Setup DLL. Утилита WCELOAD, которая устанавливает приложение на устройство, или DLL, которая загружается в этот процесс, возвратят один и тот же DPI – 96, причем вне зависимости от реального DPI устройства. Чтобы обойти эту проблему, мы запустим маленькую вспомогательную утилиту, у которой даже нет пользовательского интерфейса – она просто возвращает DPI устройства. В SDK есть пример (см. ResDLL), где используется подобная техника. Этот пример показывает, как установить DLL с ресурсами, рассчитанными на определенный DPI.

Код утилиты для определения DPI приведен ниже:

    int WINAPI WinMain( HINSTANCE hInstance,
                        HINSTANCE hPrevInstance,
                        LPTSTR    lpCmdLine,
                        int       nCmdShow)
    {
        HDC hdc = ::GetDC(NULL);
        INT ans = ::GetDeviceCaps(hdc, LOGPIXELSX);
        ::ReleaseDC(NULL, hdc);
        return ans;
    }
    

Копирование файлов, созданных под конкретное DPI

В нашем динамическом CAB-файле содержится четыре PNG-файла:

Определив DPI, мы возьмем подходящий PNG-файл и скопируем его на устройство как AppIcon.png. Файл AppIcon.png резервный и включен на тот случай, если вдруг определить DPI не удастся. После копирования оставшиеся ненужные файлы и утилита для определения DPI будут удалены.

Вот фрагмент кода из примера установочной DLL (SetupDPI). Этот код запускается после того, как приложение уже установлено на устройство, и реализует все сказанное выше:

    wsprintf(szFile,_T("%s\\%s"), pszInstallDir, _T("\\GetRealDPI.EXE"));
    // Launch DPI Detector
    ::CreateProcess(szFile, NULL, NULL, NULL, NULL, 0, NULL, NULL, NULL, &pi);
    ::WaitForSingleObject(pi.hProcess, 10000);
    // DPI is returned in exit code of detector app
    ::GetExitCodeProcess(pi.hProcess, &nSystemDPI);
    ::CloseHandle(pi.hProcess);
    ::DeleteFile(szFile);
    

    // Based on DPI, copy xx.png to AppIcon.png and delete unused files
    wsprintf(szOutFile,_T("%s\\%s"), pszInstallDir, szTargetFilename);
    for (INT i=0;i<ARRAYSIZE(DPI_Icon);i++)  {
        wsprintf(szFile,_T("%s\\%s"), pszInstallDir, DPI_Icon[i].lpstrIconSize);
        if (DPI_Icon[i].DPI==nSystemDPI) {
            ::CopyFile(szFile, szOutFile, FALSE);
        }
        ::DeleteFile(szFile);
    }
    

Создание ярлыка

Как уже говорилось, мы выполняем пост-обработку файлов уже после того, как приложение уже установлено (этим занимается функция Install_Exit). Поскольку картинка со значком для стартового экрана задается при создании ярлыка, необходимо создать ярлык в установочной DLL, а не в CAB-файле, как мы делали при статической инсталляции, в противном случае на стартовый экран попадет не PNG-файл, а значок из EXE-файла. Ниже приведен фрагмент кода для создания ярлыка. Этот код не зависит от языка операционной системы, работающей на устройстве.

    // Build lnk filename
    PTCHAR pAppDir = wcsrchr(pszInstallDir, '\\');
    TCHAR szShortcutPath[MAX_PATH];
    // CSIDL_PROGRAMS == \Windows\Start Menu\Programs
    SHGetSpecialFolderPath(hwndParent, szShortcutPath, CSIDL_PROGRAMS , false);
    wsprintf(szFile,_T("%s%s%s"), szShortcutPath, pAppDir, _T(".lnk"));
    

    // Build exe filename
    // CSIDL_PROGRAM_FILES == \Program Files
    SHGetSpecialFolderPath(hwndParent, szShortcutPath, CSIDL_PROGRAM_FILES  , false);
    wsprintf(szOutFile,_T("\"%s%s%s%s\""),
         szShortcutPath, pAppDir, pAppDir, _T(".exe"));
    

    SHCreateShortcut(szFile, szOutFile);
    

Обход кэширования иконок

Возможно, в процессе разработки вы захотите посмотреть, как выглядят разные варианты значков, и для этого подменить PNG-файлы. Имейте в виду, что если вы просто замените PNG-файл, новый значок на стартовом экране не появится, поскольку после создания ярлыка оболочка для повышения производительности кэширует значки, и при необходимости достает их из кэша. Кэш же перестраивается при загрузке операционной системы. Существует, однако, обходной путь для решения этой проблемы. Чтобы им воспользоваться, вам нужно:

1. Удалить ярлык.
2. Переименовать нужный EXE-файл. Например, hello.exe можно переименовать в hello1.exe.
3. Создать ярлык, ссылающийся на новый EXE-файл.

Ниже приведен XML-файл, содержащий инструкции для утилиты RapiConfig.exe, который как раз это и делает.

<wap-provisioningdoc>
<characteristic type="FileOperation">
  <!-- Delete Shortcut -->
  <characteristic type="%CE11%\SMS Intercept.lnk" translation="install">
    <characteristic type="Delete">
    <parm name="ForceDelete"/>
    </characteristic>
  </characteristic>

<!-- Copy EXE name to new EXE -->
    <characteristic type="%CE1%\sms Intercept\sms Intercept1.exe" 
          translation="install">
    <characteristic type="Copy">
    <parm name="Source" value="%CE1%\sms Intercept\sms Intercept.exe" 
          translation="install"/>
    </characteristic>
  </characteristic>

<!-- Create new shortcut pointing to new EXE name -->
    <characteristic type="%CE11%" translation="install">
    <characteristic type="MakeDir" /> 
      <characteristic type="SMS Intercept.lnk" translation="install">
        <characteristic type="Shortcut">
        <parm name="Source" value="%CE1%\sms Intercept\sms Intercept1.exe" 
              translation="install" /> 
        </characteristic>
      </characteristic>
    </characteristic>
</characteristic>
</wap-provisioningdoc>
    

Ярлыки для папки с играми

Если приложение устанавливается в папку с играми, ключ реестра, указывающий на PNG-файл, будет выглядеть так:

    [HKEY_LOCAL_MACHINE\Security\Shell\StartInfo\Start\Games\Phone.lnk]
    "Icon"="\Application Data\My App\newphoneicon.png"
    

Возникает вопрос: «Как создать ключ реестра, содержащий путь к папке с играми, чтобы этот путь не зависел от языка операционной системы?» Оболочка будет искать ярлыки (.lnk-файлы) в папках меню «Пуск», следовательно, нужно, чтобы в ключе было прописано локализованное имя папки Games. Для этого потребуется установочная DLL. Пример кода вы можете взять здесь.

Чтобы ярлык был создан именно в папке с играми, необходимо изменить следующую строку в файле SetupDPI.CPP и пересобрать проект:

    // Set this to true to create shortcut and 
    // registry key in the localized 'Games' Folder
    BOOL g_bCreateInGamesFolder=FALSE;
    

Заключение

Теперь вам должно быть понятно, как включать в CAB-файлы значки в формате PNG для использования на стартовом экране Windows Mobile 6.5.

По данной теме уже подготовлен список часто задаваемых вопросов, вы можете посмотреть его здесь: Start Screen PNG Icon FAQ.

• Главная
• Статьи
• ВОТ
• Видеопримеры
• Ссылки