Соглашения об именах для функций IBAction - PullRequest
Новая
       7

Соглашения об именах для функций IBAction

22 голосов
/ 28 августа 2011

Я делаю другое приложение для iOS, и мне интересно, есть ли какие-либо соглашения об именах или передовые практики в отношении того, как назвать действия, которые я мог бы выполнить. Я думаю об именах функций, которые вызываются, когда пользователь, например, касается кнопки.

Ответы [ 3 ]

24 голосов
/ 28 августа 2011

Следуйте рекомендациям Apple.То, что в прошлом было хорошим предложением, теперь кодифицировано в ARC (Автоматический подсчет ссылок), и необходимо, чтобы ARC генерировал правильный код.Использование этих рекомендаций может обеспечить безопасность вашего кода в будущем, это было сделано для ARC!

Руководства Apple Рекомендации по кодированию для какао

Из раздела имен методов:

Начните имя с буквы в нижнем регистре и начните с заглавной буквы в начале слова.Не используйте префиксы.

Есть два конкретных исключения из этих рекомендаций.Вы можете начать имя метода с общеизвестной аббревиатуры в верхнем регистре (например, TIFF или PDF), и вы можете использовать префиксы для группировки и идентификации частных методов

Для методов, которые представляют действия, выполняемые объектом, запуститеимя с глаголом. 

- (void)invokeWithTarget:(id)target;
- (void)selectTabViewItem:(NSTabViewItem *)tabViewItem

Не используйте «делать» или «делает» как часть имени, потому что эти вспомогательные глаголы редко добавляют значение.Кроме того, никогда не используйте наречия или прилагательные перед глаголом.

Если метод возвращает атрибут получателя, назовите метод после атрибута.Использование «get» не является необходимым, если только одно или несколько значений не возвращаются косвенно. 

- (NSSize)cellSize;

Используйте ключевые слова перед всеми аргументами. 

- (void)sendAction:(SEL)aSelector to:(id)anObject forAllCells:(BOOL)flag

Создайте слово перед аргументом, описывающимаргумент. 

- (id)viewWithTag:(int)aTag;
5 голосов
/ 28 августа 2011

Я не особо сталкивался с особенностями соглашений об именах для IBActions. Однако, если вы будете следовать тенденции, которую Apple, похоже, устанавливает в своих образцах приложений, то вот несколько примеров: 

-(IBAction)cameraAction:(id)sender;
-(IBAction)done:(id)sender;
-(IBAction)takePhoto:(id)sender;

Надеюсь, это поможет.

4 голосов
/ 28 августа 2011

Я думаю, что любое имя метода в Objective - C должно быть читаемым, как вы читаете английское предложение. Скажем ниже метод. 

[fileWrapper writeToFile: path atomically: YES updateFilenames: YES]; 
// This is not a real example but purpose of sharing is to make sure 
   method name is readable, so programmers can actually read code and can
   have SmallTalk.

Когда вы читаете слева направо, это помогает вам читать и объясняет, что он собирается делать.

Проверьте эту ссылку ниже,

http://cocoadevcentral.com/articles/000082.php

Jump on page No. 5 of 7

Было дано много советов. Дополнительные советы можно найти в библиотеке разработчика Apple.

Счастливое кодирование

...