Работа со списками свойств в Xamarin. iOSWorking With Property Lists in Xamarin.iOS

В этом документе Visual Studio для Mac представлен графический и расширенный редактор списка свойств (plist) для работы с info. plist и назначениями. plist. Здесь показано, как задать значки и изображения для запуска приложений iOS в Visual Studio для Mac.This document introduces Visual Studio for Mac's graphical and advanced property list (.plist) editor for working with Info.plist and Entitlements.plist. It illustrates setting icons and launch images for iOS applications from inside Visual Studio for Mac.

Visual Studio для Mac содержит графический редактор plist, который упрощает редактирование свойств и возможностей приложения.Visual Studio for Mac features a graphical .plist editor that makes editing app properties and capabilities easier. Visual Studio для Mac имеет два. плистс — Info.plist для редактирования свойств и значков приложения, Entitlements.plist а для управления возможностями приложения.Visual Studio for Mac has two .plists - Info.plist for editing app properties and icons, and Entitlements.plist for managing app capabilities. В этом руководством содержатся сведения о работе с ними в Visual Studio для Mac.This guide introduces the Info.plists and provides an overview of working with them in Visual Studio for Mac. Сведения о правах на plist см. в разделе Работа с назначениями.For information on Entitlements.plist, see the Working with Entitlements guide.

Info.plistInfo.plist

Список информационных свойств ( Info.plist) — это обязательный файл iOS, который предоставляет сведения о конфигурации приложения в системе.The Information Property List ( Info.plist) is a required iOS file that provides information about your application's configuration to the system. В пользовательском Info.plist редакторе Visual Studio для Mac три панели, управляемые вкладками в нижней левой части окна редактора:Visual Studio for Mac's custom Info.plist editor features three panels controlled by tabs at the bottom left of the editor window:

Каждая панель управляет различными свойствами, как описано ниже.Each panel controls different properties, as outlined below:

  • Панель приложений — графический интерфейс для задания общих свойств приложения, а также значков и изображений запуска; Укажите режим интеграции карт и режимы фонового режима.Application Panel - A graphical interface to set common application properties as well as icons and launch images; specify maps integration and backgrounding modes.
  • Расширенная панель . на панели «Дополнительно» можно указать поддерживаемые типы документов, UTI и URL-адреса.Advanced Panel - The advanced panel is the place to specify supported document types, UTIs, and URL types.
  • Панель исходного кода — панель исходного кода управляет менее распространенными свойствами, а также пользовательскими свойствами приложения.Source Panel - The source panel controls less common properties as well as custom properties for the application.

Следующие три раздела подробно изучите функции каждой панели.The next three sections investigate the features of each panel in more detail.

Панель приложенияApplication Panel

Visual Studio для Mac содержит графический интерфейс для изменения общих Info.plist записей приложения.Visual Studio for Mac features a graphical interface for editing common Info.plist entries for an application:

  1. Свойства приложенияApplication properties
  2. Поддерживаемые типы устройствSupported device types
  3. Поддержка ориентации для каждого типа устройстваSupport orientations for each device type
  4. Стиль и цвет строки состоянияStatus bar style and color
  5. Значки и экраны запускаIcons and start-up screens
  6. Карты и фоновые режимыMaps and Background Modes

Они описаны более подробно в следующих разделах.These are described in more detail in the next sections.

Целевая версия приложения iOSiOS Application Target

В этом разделе содержатся важные сведения, описывающие ваше приложение.This section contains important information that describes your application. Сохраненный здесь идентификатор должен соответствовать идентификатору пакета, введенному в iTunes Connect (для приложений магазина приложений), а также в списке идентификаторов приложений портала подготовки iOS и сертификатах разработки и распространения.The Identifier stored here must match the Bundle Identifier that is entered in iTunes Connect (for App Store apps) and also in the iOS Provisioning Portal App IDs list and Development and Distribution certificates.

Развертывание устройстваDevice Deployment

Разделы сведений о развертывании устройств отображаются выборочно, в зависимости от выбора в раскрывающемся списке устройства в разделе цель приложения выше.The device Deployment info sections are displayed selectively, depending on the selection in the Devices dropdown in the Application Target section above. Раскрывающийся список главного интерфейса установлен в файл mainstoryboard в приложениях, управляемых раскадровкой.The Main Interface drop-down is set to MainStoryboard in Storyboard-driven applications. Если пользовательский интерфейс полностью написан в коде, его можно оставить пустым.If the user interface is entirely written in code then this can be left blank.

Поддерживаемые ориентации устройствSupported Device Orientations

Поддерживаемые ориентации устройств определяет, как приложение реагирует на вращение устройства.Supported Device Orientations controls how the app responds to device rotation. Приложения для iPhone и iPad очень часто поддерживают только книжную ориентациюили все, но не более ногами.It is very common for iPhone/iPad apps to support only Portrait, or everything but Upside Down. Как правило, все приложения iPad, кроме игр, должны поддерживать все ориентации.Generally all iPad applications except games should support all orientations.

Стили строки состоянияStatus Bar Styles

В разделе стили строки состояния представлен графический интерфейс для редактирования приложения UIStatusBarStyle.The Status Bar Styles section is a graphical interface for editing an application's UIStatusBarStyle:

Значки, изображения для запуска и иллюстрации iTunesIcons, Launch Images, and iTunes Artwork

Сведения об использовании значков, изображений и иллюстраций в файле info. plist можно найти в разделе Working with Images Guide ( Работа с образами).Information on using icons, images, and artwork in your Info.plist file can be found in the Working with Images guide.

Интеграция карт и фоновые режимыMaps Integration and Background Modes

Info.plist Содержит специальные разделы для указания интеграции карт и режимов фонового режима.The Info.plist contains special sections to specify maps integration and backgrounding modes. При выборе параметров, которые будут поддерживаться, в приложение будут добавлены необходимые свойства.Choosing the options you want to support will add the required properties to your application for you.

Дополнительные сведения о работе с картами см. в руководстве по использованию Xamarin iOS Maps .For more information on working with maps, refer to the Xamarin iOS Maps guide.

Дополнительные сведения о фоновых режимах см. в статье о фоновом развертывании Xamarin в iOS .For more information on Background Modes, refer to the Xamarin Backgrounding in iOS guide.

Расширенная панельAdvanced Panel

Панель «дополнительно» управляет типами документов и схемами URL-адресов, которые поддерживает приложение.The advanced panel controls the document types and URL schemes that the application supports.

Типы документовDocument Types

Для приложений, поддерживающих открытие файлов конкретных типов, в CFBundleDocumentTypes iOS имеется ключ.For applications that support opening specific types of files, iOS provides the CFBundleDocumentTypes key. Если нам требуется, чтобы наше приложение поддерживало определенные известные типы файлов, например PDF-файлы, мы будем добавлять в ключ значение PDF.If we want our application to support certain known file types - for example PDFs - we would add the PDF value to the key. Этот раздел предоставляет удобный способ ввода данных, которые будут храниться в CFBundleDocumentTypes ключе Info.plist файла.This section provides a convenient way to enter the data that will be stored in the CFBundleDocumentTypes key in the Info.plist file.

Дополнительные сведения о настройке этих значений см. в документации по регистрации типов файлов, поддерживаемых приложением .Refer to the documentation on Registering the File Types Your App Supports for details on how to configure these values.

UTIUTIs

Иногда приложению требуется поддержка открытия пользовательского типа файлов.Sometimes an application needs to support opening a custom file type. Например, может потребоваться открыть файлы изображений с пользовательским расширением ксам.For example, we may want to open image files with a custom extension .xam. Чтобы указать пользовательский тип файла, мы создадим пользовательский UTI-универсальный идентификатор типа с помощью UIExportedTypeDeclarations ключа.To specify a custom file type, we'll create a custom UTI - Universal Type Identifier - using the UIExportedTypeDeclarations key. На следующем снимке экрана показано, как создать пользовательский UTI для расширения. ксам:The screenshot below illustrates how to create a custom UTI for the .xam extension:

Как и экспортированный тип UTI укажите пользовательские UTI, относящиеся к вашему приложению, импортированный тип UTI ( UIImportedTypeDeclarations ключ) указывает, что пользовательские типы поддерживаются, но не принадлежат вашему приложению.Just as exported type UTIs specify custom UTIs specific to your app, the imported type UTIs ( UIImportedTypeDeclarations key) specify custom types supported but not owned by your application.

Дополнительные сведения об использовании пользовательских UTI см. в статье Регистрация типов файлов, поддерживаемых приложением , в Apple.For more information on using custom UTIs, refer to Apple's Registering File Types Your App Supports guide.

Настраиваемые URL-адресаCustom URLs

Имя схемы URL-адреса (также называемое Protocol) является первой частью URL-адреса.A URL scheme name (also called protocol) is the first part of the URL. Например, http:// и https:// являются общими схемами URL-адресов.For example, http:// and https:// are common URL schemes. Вы можете создать настраиваемую схему URL-адресов для приложения.You have the option of creating a custom URL scheme for your application. Пользовательские схемы URL-адресов используются для обмена данными и их отправки с другими приложениями.Custom URL schemes are used to communicate and send data back and forth with other applications. На следующем снимке экрана показано, как создать настраиваемую monkeys://схему URL-адресов с именем:The following screenshot illustrates creating a new custom URL scheme called monkeys://:

Дополнительные сведения о реализации пользовательских схем URL-адресов см. в разделе Реализация пользовательских схем URL-адресов в этом руководстве .For more information on implementing custom URL schemes, refer to Apple's Implementing Custom URL Schemes section of this guide

Панель источникаSource Panel

На вкладке Info.plist источник файла можно добавлять или изменять пользовательские значения.The Source tab of the Info.plist file allows custom values to be added or edited. Visual Studio для Mac предоставляет список наиболее распространенных свойств:Visual Studio for Mac provides a list of the most common properties:

Для известных свойств Visual Studio для Mac будет иметь список допустимых значений, как показано на следующем снимке экрана:For known properties Visual Studio for Mac will a list of valid values, as illustrated by the following screenshot:

Visual Studio для Mac также определяет тип свойства, как показано ниже.Visual Studio for Mac also detects the Property Type, as shown:

Дополнительные сведения о дополнительных свойствах см. в ссылках на ресурсы, связанные с приложением Apple.Review Apple’s App Related Resources links for additional information on optional properties.

СводкаSummary

В этой статье показано, как использовать графические и Расширенные редакторы plist для изменения стандартных конфигураций приложений, а также для указания значков и образов запуска.This article demonstrated using the graphical and advanced .plist editors to edit common app configurations as well as to specify icons and launch images. Он также появился Entitlements.plist для добавления возможностей приложения и управления ими.It also introduced the Entitlements.plist for adding and managing app capabilities.