Введение в кодирование инструкций для какао

Разрабатывание Какао платформа, плагин или другая исполнимая программа с общедоступным API требует некоторых подходов и соглашений, отличающихся от используемых в разработке приложений. Основные клиенты Вашего продукта являются разработчиками, и важно, чтобы они не были мистифицированы Вашим программируемым интерфейсом. Это - то, где соглашения о присвоении имен API пригождаются, поскольку они помогают Вам сделать свои интерфейсы непротиворечивыми и ясными. Там также программируют методы, которые являются особенными для — или большей важности с — платформы, такими как управление версиями, совместимость на уровне двоичных кодов, обработка ошибок, и управление памятью. Эта тема включает информацию и о соглашениях о присвоении имен Какао и о рекомендуемых практиках программирования для платформ.

Организация этого документа

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

• Основы именования кода

• Именование методов

• Именование функций

• Именование свойств и типов данных

• Приемлемые сокращения и акронимы

Вторая группа (в настоящее время с членством одного) обсуждает аспекты программирования платформы:

• Подсказки и методы для разработчиков инфраструктуры