BlockHook Download - BlockHook Código -fonte Download

BlockHook

Outro código-fonte

1.5.12

Baixar

BlockHook

Gancho Objetivo-C blocos com libffi. É uma ferramenta AOP poderosa para blocos. O BlockHook pode executar seu código antes/, em vez disso, depois de invocar um bloco. O BlockHook pode até notificá -lo quando um bloco Dealloc. Você pode rastrear todo o ciclo de vida de um bloco usando o BlockHook!

Deseja conectar blocos passando para métodos? Experimente o BlockTracker!

? Características

? Exemplo

O BlockHook precisa de Libffi, que suporta iOS, TVOS e MacOS. Você pode executar BlockHookSample iOS , BlockHookSample tvOS ou BlockHookSample macOS Target.

? Como usar

Apenas enganche

Você pode conectar um bloco usando 4 modos (antes/em vez de/depois/mortos). Este método retorna uma instância BHToken para mais controle. Você pode remove um BHToken ou definir o valor de retorno personalizado em sua propriedade retValue . Chamando o método invokeOriginalBlock invocará a implementação original do bloco.

- (BHToken *)block_hookWithMode:(BlockHookMode)mode
                     usingBlock:( id )block

BlockHook é fácil de usar. Suas APIs recebem exemplo por aspectos. Aqui está um conjunto completo de uso do BlockHook.

Este é um exemplo para o bloco de conexão em todos os modos. Você pode alterar o valor de retorno do bloco de 8 para 15. Em seguida, remova um gancho e verifique se ele é bem -sucedido. Finalmente, recebemos retorno de chamada quando o Block Dealloc.

 NSObject *z = NSObject .new;
int (^block)( int x, int y) = ^ int ( int x, int y) {
    int result = x + y;
    NSLog ( @" %d + %d = %d , z is a NSObject: %@ " , x, y, result, z);
    return result;
};
    
BHToken *token = [block block_hookWithMode: BlockHookModeDead|BlockHookModeBefore|BlockHookModeInstead|BlockHookModeAfter usingBlock: ^(BHInvocation *invocation, int x, int y) {
    int ret = 0 ;
    [invocation getReturnValue: &ret];
    switch (invocation. mode ) {
        case BlockHookModeBefore:
            // BHInvocation has to be the first arg.
            NSLog ( @" hook before block! invocation: %@ " , invocation);
            break ;
        case BlockHookModeInstead:
            [invocation invokeOriginalBlock ];
            NSLog ( @" let me see original result: %d " , ret);
            // change the block imp and result
            ret = x * y;
            [invocation setReturnValue: &ret];
            NSLog ( @" hook instead: '+' -> '*' " );
            break ;
        case BlockHookModeAfter:
            // print args and result
            NSLog ( @" hook after block! %d * %d = %d " , x, y, ret);
            break ;
        case BlockHookModeDead:
            // BHInvocation is the only arg.
            NSLog ( @" block dead! token: %@ " , invocation. token );
            break ;
        default :
            break ;
    }
}];
    
NSLog ( @" hooked block " );
int ret = block( 3 , 5 );
NSLog ( @" hooked result: %d " , ret);
// remove token.
[token remove ];
NSLog ( @" remove tokens, original block " );
ret = block( 3 , 5 );
NSLog ( @" original result: %d " , ret);

Aqui está o log:

 hooked block
hook before block! invocation:<BHInvocation: 0x60b00003c370>
3 + 5 = 8, z is a NSObject: <NSObject: 0x6020000279d0>
let me see original result: 0
hook instead: '+' -> '*'
hook after block! 3 * 5 = 15
hooked result:15
block dead! token:<BHToken: 0x60d000004bd0>
remove tokens, original block
3 + 5 = 8, z is a NSObject: <NSObject: 0x6020000279d0>
original result:8

Interceptador de bloco

Às vezes, você deseja o login do usuário antes de rotear para outros componentes. Para interceptar um bloco sem invadir o código de roteadores, você pode usar o Block Interceptor.

 NSObject *testArg = [ NSObject new ];
NSObject *testArg1 = [ NSObject new ];
    
NSObject *(^testblock)( NSObject *) = ^( NSObject *a) {
    return [ NSObject new ];
};
    
[testblock block_interceptor: ^(BHInvocation *invocation, IntercepterCompletion  _Nonnull completion) {
    dispatch_after ( dispatch_time (DISPATCH_TIME_NOW, ( int64_t )( 0.5 * NSEC_PER_SEC)), dispatch_get_main_queue (), ^{
        NSObject * __unsafe_unretained arg;
        [invocation getArgument: &arg atIndex: 1 ];
        NSLog ( @" Original argument: %@ " , arg);
        [invocation setArgument: ( void *)&testArg1 atIndex: 1 ];
        completion ();
    });
}];
    
testblock (testArg);

? Instalação

Cocoapods

O Cocoapods é um gerente de dependência de projetos de cacau. Você pode instalá -lo com o seguinte comando:

$ gem install cocoapods

Para integrar o BlockHook ao seu projeto Xcode usando Cocoapods, especifique -o no seu Podfile :

 source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!
target 'MyApp' do
	pod 'BlockHook'
end

Você precisa substituir "MyApp" pelo nome do seu projeto.

Em seguida, execute o seguinte comando:

$ pod install

Cartago

Cartago é um gerente de dependência descentralizado que cria suas dependências e fornece estruturas binárias.

Você pode instalar Cartago com Homebrew usando o seguinte comando:

$ brew update
$ brew install carthage

Para integrar o BlockHook ao seu projeto Xcode usando Cartago, especifique -o no seu Cartfile :

 github "yulingtianxia/BlockHook"

Execute carthage update para criar a estrutura e arrastar o BlockHook.framework construído para o seu projeto Xcode.

Manual

Depois de importar a libffi, basta adicionar os dois arquivos BlockHook.h/m ao seu projeto.

❤️ Contribuiu

Se você precisar de ajuda ou deseja fazer uma pergunta geral , abra um problema.
Se você encontrou um bug , abra um problema.
Se você tiver uma solicitação de recurso , abra um problema.
Se você deseja contribuir , envie uma solicitação de tração.