Feature Flags & cfg

Use recursos do Cargo e #[cfg(feature = ...)] para controlar logs de depuração, instruções exclusivas para desenvolvimento e código específico de cluster em programas Anchor.

Receita

[features]
default = []
debug-log = []
devnet-only = []

#[cfg(feature = "debug-log")]
msg!("debug");

Quando usar isso: Você precisa de builds diferentes para dev vs mainnet ou diagnósticos opcionais.

Exemplo de Trabalho

Controle a instrução, não o módulo #[program]. Dois módulos cfg-selecionados com o mesmo nome são frágeis e fáceis de errar; um único módulo com um manipulador com cfg compilado limpa e mantém uma forma de IDL por build.

use anchor_lang::prelude::*;
 
declare_id!("Fg6PaFpoGXkYsidMpWTK6W2BeZ7FEfcYkg476zPFsLnS");
 
#[program]
pub mod my_program {
    use super::*;
 
    pub fn settle(_ctx: Context<Settle>) -> Result<()> {
        Ok(())
    }
 
    /// Compilado inteiramente, a menos que `--features devnet-only`.
    #[cfg(feature = "devnet-only")]
    pub fn airdrop_test_tokens(_ctx: Context<Airdrop>) -> Result<()> {
        Ok(())
    }
}
 
#[derive(Accounts)]
pub struct Settle<'info> {
    pub authority: Signer<'info>,
}
 
#[cfg(feature = "devnet-only")]
#[derive(Accounts)]
pub struct Airdrop<'info> {
    pub authority: Signer<'info>,
}

O que isso demonstra:

• Recursos controlam a inclusão em tempo de compilação
• Binário menor para mainnet sem instruções de dev
• Controle manipuladores e suas structs Accounts juntos, não o módulo #[program]
• A build devnet emite um IDL diferente - envie a build de recursos padrão para mainnet
• Documente os recursos no README

Mergulho Profundo

Ressalva do Anchor

Dividir módulos #[program] por cfg altera o IDL entre builds. Prefira crates de desenvolvimento separados ou instruções protegidas por chaves de administrador em vez de enviar instruções de dev para mainnet.

Padrão de recurso de cluster

Use constantes em Anchor.toml / scripts de build em vez de múltiplos módulos #[program] quando possível.

Armadilhas

• IDL diferente por conjunto de recursos - Confusão do cliente. Correção: Um perfil de release para mainnet.
• Habilitar acidentalmente devnet-only na mainnet - Superfície de ataque extra. Correção: CI proíbe combinação de recursos.
• cfg em structs de conta - Desvio de layout do IDL. Correção: Mantenha o layout da conta estável entre builds.
• Recurso de logs de depuração deixado ativado - Desperdício de CU. Correção: Recursos padrão vazios.
• Erro de dois módulos #[program] - Erros de compilação. Correção: Módulo de programa único por build.

Alternativas

FAQs

Relacionado

• Logging & CU Cost - logs de depuração
• Program Upgrades - releases
• Making Programs Immutable - deploy final

Versões da Stack: Esta página foi escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0, e LiteSVM 0.6.x.

Y29kZWd1aWRlcy5pb3xjZ2lvMjkwfDIwMjYwNw