Глава 16. Документация разработчика ________________________________________________________________________________________________
• Примеры кода: небольшие законченные проекты, которые демонстрируют, как фирма Applе рекомендует использовать свои технологии. Например, проект WeatherMap показывает, как создавать пользовательские аннотации при отображении карт в iOS. • Замечания к текущей версии: при выходе каждой новой версии Мас OS или iOS прилагается документация, в которой описаны изменения текущей версии по сравнению с предыдущей. • Технические комментарии, статьи, советы по программированию, технические вопросы и ответы: небольшие документы с описанием конкретных проблем. Документацию можно просматривать, но ее объем очень велик. Чаще документация используется для поиска ответов на конкретные вопросы.
Справочные страницы Щелкните на кнопке в верхней части левой панели Оrgаnizег, чтобы вызвать панель поиска. Введите условие поиска NSArray; ниже появляются результаты поиска. В разделе Reference щелкните на ссылке NSArray, чтобы просмотреть справочную страницу класса NSArray. Трудно переоценить важность справочных страниц для вас и для программистов всех уровней. Фирма Apple основательно потрудилась над созданием огромных библиотек программного кода, упрощающих вашу работу. Основным источником информации об этих библиотеках являются справочные страницы. Не жалейте времени на просмотр справочных страниц новых классов, с которыми вы познакомитесь в этой книге, и ознакомьтесь с их возможностями. Также возможен поиск по именам методов, функций, констант и свойств (о том, что такое свойства, будет рассказано в главе 17). Чем увереннее вы будете работать со справочными страницами, тем быстрее пойдет ваша работа. В начале справочного описания класса NSArray при водятся некоторые общие сведения о классе. В частности, класс является производным от NSObject (подробности также при водятся в главе 18). Он поддерживает некоторые протоколы (эта тема будет рассмотрена в главе 25). Ои является частью библиотеки Foundation и входит в поставку всех версий Мас OS Х и всех версий iOS. В конце заголовка приводится список руководств с описаниями класса NSArray и примеров кода, демонстрирующих его. Щелкните на ссылке Collections Programming Тopics, чтобы открыть руководство по работе с коллекциями. В этом конкретном руководстве обсуждается работа с классами коллекций (включая NSArray и NSМutаblеАrrау). В отличие от справочника по классам, руководство легко читается, а материал излагается логично и последовательно.
94
ptg999