OCUnit в XCode 4.5 для новичков

Однажды мне надоело, что исправление багов занимает у меня больше времени, чем разработка приложения, и в поисках путей решения я пришел к TDD — Test-driven development (Разработка через тестирование).

В это статье рассказывается как делать первые шаги в XCode 4.5, используя unit test-ы, при разработки приложений под IOS.

Статья предназначена для новичков, в ней не содержится информации для зубров разработки.

Введение

Начнем с самого начала, создадим новый проект, отметим галочку «Include Unit Tests» и назовем его Ocu:
file -> new -> project -> single view application

Я предпочитаю не использовать ARC, так как придерживаюсь правила, что новые фичи должны полежать пока их не доведут до ума, а он появился всего год назад. Да и ручное управление памятью не такая уж сложная штука, и небольшая практика в этом будет полезна.

Мы создали проект в который включен фреймворк SenTestingKit, этот фреймворк и будет нам помогать.
В проекте видим 2 группы — Ocu и OcuTests, в первой содержится код нашего прилложения, во второй юнит тесты.


Откроем файл «OcuTests.m» и найдем метод «testExample».
OcuTests.m

#import "OcuTests.h"

@implementation OcuTests

- (void)setUp
{
    [super setUp];
    
    // Set-up code here.
}

- (void)tearDown
{
    // Tear-down code here.
    
    [super tearDown];
}

- (void)testExample
{
    STFail(@"Unit tests are not implemented yet in OcuTests");
}

@end

setUp — это метод который выполнится перед началом тестирования, тут можно инициализировать все объекты, которые нам понадобятся для теста.
tearDown — это метод который выполнится после окончания тестирования, тут можно уничтожить все использованные нами объекты.
testExample — это самый первый тест, который мы выполним, он содержит простой макрос который вызовет сообщение об ошибке и напишет, что мы еще не создали ни одного юнит теста.

Вообще, если название метода начинается на test и он возвращает void, то SenTestingKit автоматически распознает его как тест и выполнит.

Запустим тест (нажатием «cmd+U» или нажав на кнопку «Run» и подержав ее, выбираем из выпавшего списка «Test») и посмотрим что нам напишет дебаггер.

Test Suite 'OcuTests' started at 2012-11-22 22:27:01 +0000.
Test Case '-[OcuTests testExample]' started.
/Ocu/OcuTests/OcuTests.m:29: error: -[OcuTests testExample] : Unit tests are not implemented yet in OcuTests
Test Case '-[OcuTests testExample]' failed (0.000 seconds).
Test Suite 'OcuTests' finished at 2012-11-22 22:27:01 +0000.
Executed 1 test, with 1 failure (0 unexpected) in 0.000 (0.000) seconds

Дебаггер написал что выполнен 1 тест, и тест не пройден, и выдал нам описание которое мы поставили в макросе.

Теперь мы знаем где писать тест, как его запустить и где посмотреть результат выполнения. Приступим к написанию самого простого теста.

Пример 1 — проверка сложения

В этом примере мы просто создадим 2 переменные и проверим результат их сложения.

Определим 2 переменные, которые будем складывать, и метод в котором будет содержаться наш тест.
OcuTests.h

#import <SenTestingKit/SenTestingKit.h>

@interface OcuTests : SenTestCase
{
    float foo;
    float bar;
}

- (void) testMathAdd;

@end

В методе setUp проинициализируем переменные и присвоим им значение, а в методе testMathAdd проверим результат сложения.
OcuTests.m

- (void)setUp
{
    [super setUp];
    
    foo = 2.0;
    bar = 5.0;
}

- (void)tearDown
{
    // Tear-down code here.
    
    [super tearDown];
}

- (void) testMathAdd
{
    STAssertTrue (foo + bar == 6.0, @"%f + %f should be 7.0", foo, bar);
}

Запускаем тесты «cmd+U» и видим сообщение об ошибке с комментарием.

Test Suite 'OcuTests' started at 2012-11-23 12:26:14 +0000
Test Case '-[OcuTests testMathAdd]' started.
/Ocu/OcuTests/OcuTests.m:30: error: -[OcuTests testMathAdd] : "foo + bar == 6.0" should be true. 2.000000 + 5.000000 should be 7.0
Test Case '-[OcuTests testMathAdd]' failed (0.000 seconds).
Test Suite 'OcuTests' finished at 2012-11-23 12:20:42 +0000.
Executed 1 test, with 1 failure (0 unexpected) in 0.000 (0.000) seconds

В комментарии указано что результат сложения отличается от ожидаемого, исправим ошибку.
OcuTests.m

- (void) testMathAdd
{
    STAssertTrue (foo + bar == 7.0, @"%f + %f should be 7.0", foo, bar);
}

Запускаем тест и видим сообщение о том, что тест пройден.

Test Suite 'OcuTests' started at 2012-11-23 12:26:14 +0000
Test Case '-[OcuTests testMathAdd]' started.
Test Case '-[OcuTests testMathAdd]' passed (0.000 seconds).
Test Suite 'OcuTests' finished at 2012-11-23 12:26:14 +0000.
Executed 1 test, with 0 failures (0 unexpected) in 0.000 (0.000) seconds

Пример 2 — вычисление значения свойства объекта

В этом примере мы создадим объект, присвоим значения его свойствам и проверим правильно ли создалость еще одно свойство.

Добавим в проект новый класс — выбираем шаблон «Objective-C class» и выбираем «Subclass of NSObject», вводим название «Triangle», при сохранении отмечаем галочкой «Targets OcuTests». В итоге в группе OcuTests получаем 2 новых файла «Triangle.h» и «Triangle.m».
В них создаем необходимые методы.

Triangle.h

#import <Foundation/Foundation.h>

@interface Triangle : NSObject
{
    float cathetus1;
    float cathetus2;
}

- (id)initWithCathetus1:(float)cat1 andCathetus2:(float)cat2;
- (float)getHypotenuse;

@end

Triangle.m

#import "Triangle.h"

@implementation Triangle

- (id)initWithCathetus1:(float)cat1 andCathetus2:(float)cat2
{
    cathetus1 = cat1;
    cathetus2 = cat2;
    
    return self;
}

- (float)getHypotenuse
{
    float hypotenuse = hypotf(cathetus1, cathetus2);
    return hypotenuse;
}

@end

И соответственно делаем изменения в тестах.
OcuTests.h

#import <SenTestingKit/SenTestingKit.h>

@interface OcuTests : SenTestCase

- (void)testTriangleHypotenuse;

@end

OcuTests.m

#import "OcuTests.h"
#import "Triangle.h" // добавляем новый класс, который будем тестировать

@implementation OcuTests

- (void)setUp
{
    [super setUp];
}

- (void)tearDown
{    
    [super tearDown];
}

- (void)testTriangleHypotenuse
{
    float cat1 = 3.0;
    float cat2 = 4.0;
    Triangle *tri = [[Triangle alloc] initWithCathetus1:cat1 andCathetus2:cat2];
    
    STAssertTrue([tri getHypotenuse]==5.0, @"Hypotenuse should be 5.0 with catheti: %f, %f", cat1, cat2);
        
    [tri release];
}

Выполняем тест и получаем сообщение о пройденном тесте.

Test Suite 'OcuTests' started at 2012-11-23 14:25:39 +0000
Test Case '-[OcuTests testTriangleHypotenuse]' started.
Test Case '-[OcuTests testTriangleHypotenuse]' passed (0.000 seconds).
Test Suite 'OcuTests' finished at 2012-11-23 14:25:39 +0000.
Executed 1 test, with 0 failures (0 unexpected) in 0.000 (0.000) seconds

PS:
Если вам будет интересно прочитать следующую статью, то напишите, пожалуйста, какие примеры для тестирования вы хотели бы увидеть.