Приложение (схема пакета для Windows 8)

Статья
07/20/2023

Представляет приложение, включающее часть или все функции, предоставляемые в пакете.

Иерархия элементов

<Приложения>: <Развертывание>

Синтаксис

<Application Id          = An ASCII string between 1 and 64 characters in length. See the Attributes table for more information on character restrictions.
             Executable? = A string between 1 and 256 characters in length that must end with ".exe" and cannot contain these characters: <, >, :, %, ", |, ?, or *. It specifies the default executable for the extension. If not specified, the executable defined for the app is used.  If specified, the EntryPoint property is also used. If that EntryPoint property isn't specified, the EntryPoint defined for the app is used.
             EntryPoint? = A string between 1 and 256 characters in length, representing the task  handling the extension. This is normally the fully namespace-qualified name of a Windows Runtime type.
If EntryPoint is not specified, the EntryPoint defined for the app is used instead.

             StartPage?  = A string between 1 and 256 characters in length that cannot contain these characters: <, >, :, %, ", |, ?, or *. >

  <!-- Child elements -->
  ( VisualElements
  & ApplicationContentUriRules?
  & Extensions?
  )

</Application>

Ключ

? необязательно (ноль или один)

& соединитель чередования (может происходить в любом порядке)

Атрибуты и элементы

Атрибуты

Атрибут	Описание	Тип данных	Обязательно
EntryPoint	Идентификатор класса активируемого, например "" Office. Winword. class ". Для классических приложений это значение должно быть действительной точкой входа исполняемого файла, например "Main", "WinMain" или "wWinMain". Если указан этот атрибут, необходимо также указать атрибут Executable . При указании этого атрибута не следует указывать атрибут StartPage .	Строка длиной от 1 до 256 символов, представляющая задачу обработки расширения. Как правило, соответствует полному имени пространства имен типа среды выполнения Windows. Если точка входа не указана, вместо нее используется точка входа, определенная для приложения.	Нет
Исполняемый объект	Исполняемый файл запуска по умолчанию для приложения. Этот файл должен присутствовать в пакете. При указании этого атрибута необходимо указать атрибут EntryPoint . При указании этого атрибута не следует указывать атрибут StartPage .	Строка длиной от 1 до 256 символов, которая должна заканчиваться на ".exe" и не может содержать следующие символы: < , > ,:,%, ", \|,? или *. Он задает исполняемый файл по умолчанию для расширения. Если не указано, используется исполняемый файл, определенный для приложения. Если указано, также используется свойство EntryPoint. Если свойство EntryPoint не указано, используется точка входа, определенная для приложения.	Нет
Id	Уникальный идентификатор приложения в пакете. Оно также иногда называется связанным с пакетом идентификатором приложения (PRAID). ИДЕНТИФИКАТОР уникален в пределах пакета, но не глобально. Другой пакет в системе может использовать такой же идентификатор. Один и тот же идентификатор нельзя использовать несколько раз в одном пакете. Эта строка содержит буквенно-цифровые поля, разделенные точками. Каждое поле должно начинаться с буквенного символа ASCII. Их нельзя использовать в качестве значений полей: CON, PRN, AUX, NUL "," COM1 "," COM2 "," COM3 "," COM4 "," COM5 "," COM6 "," COM7 "," COM8 "," COM9 "," LPT1 "," LPT2 "," LPT3 "," LPT4 "," LPT5 "," LPT6 "," LPT7 "," LPT8 "и" LPT9 ". при использовании шаблона Visual Studio значение этого атрибута по умолчанию — "App". Разработчикам следует вручную изменить этот параметр в манифесте. идентификатор приложения не должен изменяться после публикации приложения в Microsoft Store. это приведет к нарушению расположения плитки на начальном экране.	Строка ASCII длиной от 1 до 64 символов.	Да
StartPage	HTML-страница запуска по умолчанию для приложения. Этот файл должен присутствовать в пакете. При указании этого атрибута нельзя указать атрибут EntryPoint или исполняемый атрибут.	Строка длиной от 1 до 256 символов, которая не может содержать следующие символы: < , > ,:,%, ", \|,? или *.	Нет

Дочерние элементы

Дочерний элемент	Описание
ApplicationContentUriRules	Указывает, какие страницы в веб-контексте имеют доступ к устройствам географического расположения системы (если у приложения есть разрешение на доступ к этой возможности) и доступ к буферу обмена.
Расширения (тип: CT_ApplicationExtensions)	Определяет одну или несколько точек расширяемости для приложения.
VisualElements	Описание визуальных аспектов приложения UWP: его плитки по умолчанию, изображения логотипа, цвета текста и фона, начальная ориентация экрана, экран-заставка и внешний вид плитки экрана блокировки.

Родительские элементы

Родительский элемент	Описание
Приложения	Представляет одно или несколько приложений, составляющих пакет.

Remarks

Элемент Application содержит атрибуты, общие для точек расширения, относящихся к приложению. Эти сведения используются другими точками расширения для получения сведений о приложении. Кроме того, атрибуты приложения используются при запуске и управлении экземпляром приложения.

если указан атрибут StartPage , то это Windows приложение, использующее JavaScript. Если параметр StartPage не указан, должны быть указаны атрибуты Executable и ENTRYPOINT , а также приложение UWP, использующее C# или VB и XAML.

Примеры

Следующий пример взят из манифеста пакета одного из примеров пакета SDK.

                    
<Applications>
  <Application Id="App" StartPage="default.html">

    <VisualElements DisplayName="Assocation launching sample" 
         Logo="images\squareTile-sdk.png" SmallLogo="images\smallTile-sdk.png" 
         Description="SDK sample" 
         ForegroundText="dark" BackgroundColor="#FFFFFF" ToastCapable="false">
      <DefaultTile ShowName="allLogos" />
      <SplashScreen BackgroundColor="white" Image="images\splash-sdk.png" />
    </VisualElements>

    <Extensions>
      <Extension Category="windows.fileTypeAssociation">
        <FileTypeAssociation Name=".alsdkjs">
          <SupportedFileTypes>
            <FileType>.alsdkjs</FileType>
          </SupportedFileTypes>
        </FileTypeAssociation>
      </Extension>

      <Extension Category="windows.protocol">
        <Protocol Name="alsdkjs" />
      </Extension>
    </Extensions>
  </Application>
</Applications>

Требования

	Значение
Пространство имен	`http://schemas.microsoft.com/appx/2010/manifest`