单元测试自动化实现指南

测试基础：构建可靠测试体系

验证钩子基本功能：确保AOP拦截生效

通过基础测试用例验证Aspects框架的核心拦截能力，确认钩子函数能够按预期触发。适用于所有AOP功能验证场景，局限性在于无法覆盖复杂异步场景。

- (void)testHookExecution {
    TestClass *testObject = [TestClass new];
    __block BOOL hookCalled = NO;
    
    [testObject aspect_hookSelector:@selector(testMethod) 
                       withOptions:AspectPositionAfter 
                        usingBlock:^(id<AspectInfo> info) {
        hookCalled = YES;
    } error:NULL];
    
    [testObject testMethod];
    XCTAssertTrue(hookCalled, "钩子未被触发");
}

验证钩子作用域：防止跨实例干扰

确保钩子仅对目标实例生效，避免不同实例间的测试污染。适用于实例级钩子测试，不适用于类级钩子场景。

- (void)testHookIsolation {
    TestClass *obj1 = [TestClass new];
    TestClass *obj2 = [TestClass new];
    __block NSInteger callCount = 0;
    
    [obj1 aspect_hookSelector:@selector(testMethod) 
                   withOptions:AspectPositionAfter 
                    usingBlock:^(id<AspectInfo> info) {
        callCount++;
    } error:NULL];
    
    [obj1 testMethod];
    [obj2 testMethod];
    XCTAssertEqual(callCount, 1, "钩子不应跨实例生效");
}

环境准备提示
确保项目中已包含Aspects.h/m源文件，并在测试目标中启用XCTest框架。测试文件路径：AspectsDemo/AspectsDemoTests/AspectsDemoTests.m

核心场景：覆盖关键测试需求

测试钩子执行顺序：验证调用流程

按不同位置（Before/After/Instead）注册钩子，验证执行顺序是否符合预期。适用于需要精确控制执行流程的场景，注意钩子执行顺序可能受注册顺序影响。

- (void)testHookOrder {
    __block NSMutableArray *executionOrder = [NSMutableArray array];
    
    [TestClass aspect_hookSelector:@selector(testMethod) 
                       withOptions:AspectPositionBefore 
                        usingBlock:^(id<AspectInfo> info) {
        [executionOrder addObject:@"before"];
    } error:NULL];
    
    [TestClass aspect_hookSelector:@selector(testMethod) 
                       withOptions:AspectPositionAfter 
                        usingBlock:^(id<AspectInfo> info) {
        [executionOrder addObject:@"after"];
    } error:NULL];
    
    [[TestClass new] testMethod];
    XCTAssertEqualObjects(executionOrder, @[@"before", @"after"], "执行顺序错误");
}

测试异常处理机制：验证错误反馈

故意传入错误参数，验证框架是否能正确返回错误信息。适用于边界条件测试，帮助捕获钩子注册阶段的问题。

- (void)testInvalidHook {
    NSError *error = nil;
    id<AspectToken> token = [NSObject aspect_hookSelector:@selector(init) 
                                              withOptions:AspectPositionAfter 
                                               usingBlock:^(id extraParam) {
        // 错误：缺少AspectInfo参数
    } error:&error];
    
    XCTAssertNil(token);
    XCTAssertEqual(error.code, AspectErrorIncompatibleBlockSignature);
}

测试返回值修改：验证业务逻辑干预

使用Instead类型钩子修改方法返回值，验证AOP对业务逻辑的干预能力。适用于模拟测试数据场景，注意会完全替换原方法实现。

- (void)testReturnValueModification {
    CALayer *layer = [CALayer new];
    layer.name = @"original";
    
    [layer aspect_hookSelector:@selector(name) 
                   withOptions:AspectPositionInstead 
                    usingBlock:^(id<AspectInfo> info) {
        NSString *newName = @"modified";
        [[info originalInvocation] setReturnValue:&newName];
    } error:NULL];
    
    XCTAssertEqualObjects(layer.name, @"modified", "返回值未被正确修改");
}

进阶技巧：提升测试质量与效率

实现钩子清理机制：避免测试污染

使用AspectToken的remove方法清理钩子，确保测试用例间相互独立。适用于所有测试场景，是保证测试稳定性的关键步骤。

⚠️ 注意点：务必在tearDown方法中执行钩子清理，避免测试用例间状态残留

- (void)setUp {
    [super setUp];
    self.testObject = [TestClass new];
    self.aspectToken = nil;
}

- (void)tearDown {
    [self.aspectToken remove];
    [super tearDown];
}

测试覆盖率提升：关键指标与优化

通过Xcode的测试覆盖率工具监控测试完整性，重点关注以下指标优化：

💡 技巧：优先覆盖Aspects核心API：aspect_hookSelector:withOptions:usingBlock:error:和aspect_remove方法

• 函数覆盖率：确保所有公共方法都有对应的测试用例
• 分支覆盖率：覆盖不同钩子类型（Before/After/Instead）和错误场景
• 行覆盖率：重点覆盖 Aspects.m 中的关键逻辑，如__ASPECTS_ARE_BEING_CALLED__函数

问题诊断：常见测试失败解决方案

🔍 检查点：当测试失败时，首先检查钩子注册是否成功，错误信息是否被正确捕获

1. 钩子不触发

   • 可能原因：选择器名称错误或方法签名不匹配
   • 解决方案：使用@selector()宏确保选择器正确，检查方法参数和返回值类型

2. 崩溃或内存泄漏

   • 可能原因：循环引用或钩子 block 中使用了 self
   • 解决方案：使用弱引用（__weak typeof(self) weakSelf = self;）

3. 测试间歇性失败

   • 可能原因：异步操作未正确处理
   • 解决方案：使用XCTestExpectation处理异步测试

图：Aspects钩子触发时的调用栈，显示了AOP代码如何插入到原始方法执行流程中，其中__ASPECTS_ARE_BEING_CALLED__标记为钩子执行点

工程实践：构建完整测试体系

批量测试执行：命令行与脚本

使用xcodebuild命令批量执行测试，便于集成到自动化流程。适用于日常开发和持续集成场景。

xcodebuild test -workspace Aspects.xcworkspace \
                -scheme Aspects-iOS \
                -destination 'platform=iOS Simulator,name=iPhone 15'

CI集成：GitHub Actions配置

将测试自动化集成到GitHub Actions工作流，实现每次提交自动测试。适用于团队协作和开源项目。

name: Tests
on: [push, pull_request]
jobs:
  test:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v3
      - name: Run tests
        run: |
          xcodebuild test -workspace Aspects.xcworkspace \
                          -scheme Aspects-iOS \
                          -destination 'platform=iOS Simulator,name=iPhone 15'

CI集成：GitLab CI配置

在GitLab CI中配置测试任务，实现持续集成和质量监控。适用于企业内部项目和GitLab用户。

stages:
  - test

unit_tests:
  stage: test
  tags:
    - macos
  script:
    - xcodebuild test -workspace Aspects.xcworkspace \
                      -scheme Aspects-iOS \
                      -destination 'platform=iOS Simulator,name=iPhone 15'

测试策略选择指南

根据项目需求选择合适的测试策略：

1. 单元测试：验证独立钩子功能，使用XCTest框架
2. 集成测试：验证多个钩子协同工作，建议使用测试套件组织相关用例
3. 性能测试：评估AOP对方法执行效率的影响，使用measureBlock:方法
4. 边界测试：验证极端条件下的稳定性，如大量钩子注册、nil参数处理等

通过以上测试策略的组合应用，可以构建全面的测试体系，确保Aspects框架在各种场景下的可靠性和稳定性。测试用例应随着框架功能的迭代而持续更新，保持测试与代码的同步演进。