2011-08-28 18 views
18

Robię kolejną aplikację na iOS i zastanawiam się, czy istnieją konwencje nazewnictwa lub dobre praktyki dotyczące nazywania działań, które mógłbym wykonać. Mam na myśli nazwy funkcji, które są wywoływane, gdy użytkownik np. dotyka przycisku.Konwencje nazewnictwa na temat funkcji IBAction

Odpowiedz

4

Chyba każda nazwa metody w Objective-C powinna być czytelna tak, jak czytasz angielskie zdanie. Powiedzmy poniżej metodę.

[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. 

Kiedy czytasz od lewej do prawej, możesz przeczytać i wyjaśnić sobie, co zamierza zrobić.

Sprawdź ten link poniżej,

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

Jump on page No. 5 of 7 

Istnieje wiele wskazówek nadano. Więcej wskazówek można znaleźć w bibliotece deweloperów Apple.

Szczęśliwy Coding

5

I nie natknąć się znacznie w sposób specyfikę, jeśli chodzi o konwencje nazewnictwa dla IBActions. Jednakże, jeśli były, aby zgodnie z tendencją Apple wydaje się być ustawienie w swoich przykładowych aplikacji, a następnie kilka przykładów są następujące:

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

nadzieję, że to pomaga.

+0

Przykładowy kod Apple jest odpowiedzialny za tak wiele złych praktyk. Użyj go tylko do sprawdzenia, jak działa kod struktury. Czy * nie * bierze z tego styl kodowania lub wzorce projektowe. – Jeff

20

Idź zgodnie z wytycznymi Apple. To, co było w przeszłości dobrymi sugestiami, zostało skodyfikowane w ARC (automatyczne liczenie referencyjne) i są one niezbędne do przestrzegania ARC w celu wygenerowania poprawnego kodu. Korzystanie z tych wskazówek może dobrze zabezpieczyć Twój kod w przyszłości, tak jak w przypadku ARC!

wytyczne Apple Coding Guidelines for Cocoa

W sekcji Metoda nazewnictwa:

start nazwa z małej litery i pierwszą literę słowa wbudowanych. Nie używaj prefiksów.

Istnieją dwa wyjątki od tych wytycznych. Możesz rozpocząć nazwę metody ze znanym akronimem wielkimi literami (np. TIFF lub PDF)) i możesz użyć prefiksów do grupowania i identyfikowania prywatnych metod.

Dla metod reprezentujących działania, które podejmuje obiekt, zacznij od nazwy z czasownikiem.

Nie używaj "do" lub "does" jako części nazwy, ponieważ te czasowniki posiłkowe rzadko dodają znaczenia. Nigdy też nie używaj przysłówków lub przymiotników przed czasownikiem.

Jeśli metoda zwraca atrybut odbiorcy, nazwij metodę po atrybucie. Użycie "get" nie jest konieczne, chyba że jedna lub więcej wartości zostanie zwróconych pośrednio.

- (NSSize)cellSize; 

Używaj słów kluczowych przed wszystkimi argumentami.

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

Wpisz słowo przed argumentem, aby opisać argument.

- (id)viewWithTag:(int)aTag; 
+0

Myślę, że miałeś na myśli "zostały skodyfikowane". –

+0

@Steven, dzięki, naprawione. – zaph