Editar

Partilhar via


Perguntas frequentes sobre o NuGet.org

Termos de licença

Quais são os termos de licença padrão se um pacote não fornecer informações de licença específicas?

Cada pacote é regido pelos termos incluídos no pacote. Você deve examinar os termos aplicáveis antes de acessar, baixar ou adquirir os pacotes. No NuGet.org, use o link License Info (Informações de Licença) na página do pacote.

Se um pacote não especificar os termos de licença, entre em contato com o proprietário do pacote diretamente usando o link Contact owners (Contatar os proprietários) na página do pacote do NuGet.org. A Microsoft não licencia nenhuma propriedade intelectual para você de provedores de pacotes de terceiros, nem é responsável pelas informações fornecidas por terceiros.

Gerenciando pacotes no NuGet.org

Posso editar os metadados do pacote depois que ele é carregado?

O NuGet recomenda que todos os pacotes sejam assinados. Um princípio de design da assinatura de pacote é que o conteúdo do pacote assinado deve ser imutável, que inclui o nuspec. Editar os resultados de metadados de pacote em alterações de nuspec, invalidando assinaturas existentes. É recomendável modificar fluxos de trabalho existentes para não exigir a edição dos metadados do pacote depois que o este foi criado.

Observe que as dependências listadas para seu pacote são geradas automaticamente do próprio pacote e não podem ser editadas.

Além disso, carregar pacotes para int.nugettest.org é uma ótima maneira de testar e validar seu pacote sem disponibilizá-lo na galeria pública. Ponto de Extremidade de API: https://apiint.nugettest.org/v3/index.json

Posso excluir um pacote publicado no NuGet.org?

Em geral, não oferecemos suporte à exclusão de pacotes publicados em NuGet.org. Leia mais sobre nossa política de exclusão de pacotes.

É possível reservar nomes para pacotes que serão publicados no futuro?

Sim. Você pode reservar IDs para os pacotes no NuGet.org solicitando um prefixo de ID de pacote para a sua conta. Para solicitar um prefixo da ID do pacote, siga as instruções na documentação.

Como declarar a propriedade de pacotes?

Como fazer para lidar com um proprietário de pacote que está violando minha licença de software?

Estimulamos a comunidade do NuGet para trabalhar juntos para resolver as controvérsias que podem surgir entre os proprietários do pacote e os proprietários de outro software. Criamos um processo de solução de controvérsias que deve ser seguido antes de solicitar a intervenção dos administradores do NuGet.org.

É recomendável carregar os meus pacotes de teste no NuGet.org?

Para fins de teste, você pode usar int.nugettest.org ou os servidores NuGet públicos alternativos como myget.org ou Azure DevOps.

Observe que os pacotes carregados para o int.nugettest.org podem não ser preservados.

Qual é o tamanho máximo dos pacotes que eu posso carregar no NuGet.org?

O NuGet.org permite pacotes com até 250 MB, mas é recomendável, se possível, manter os pacotes abaixo de 1 MB e usar as dependências para uni-los. Como regra geral, os pacotes contêm apenas um assembly para evitar colisões.

O NuGet usa HTTP para baixar os pacotes, por isso pacotes maiores têm maior probabilidade de apresentar falha na instalação do que os menores.

É possível compartilhar as dependências entre vários pacotes, reduzindo o tamanho total do download para os consumidores de seus pacotes do NuGet.

As dependências são principalmente estáticas e nunca mudam. Ao corrigir um bug no código, as dependências não precisarão ser atualizadas. Se você agrupar dependências, pacotes cada vez maiores são distribuídos a cada vez. Dividir os pacotes do NuGet em dependências relacionadas torna os upgrades muito mais refinados para os consumidores do seu pacote.

O NuGet.org não está acessível

A quais versões de SSL/TLS e conjuntos de codificação o NuGet.org oferece suporte?

O NuGet.org oferece suporte ao TLS 1.2 e aos seguintes conjuntos de codificação:

  • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
  • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
  • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384
  • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

Por que não consigo restaurar pacotes do NuGet.org?

Se você encontrar falhas transitórias ao restaurar pacotes de NuGet.org, sugerimos:

  • usar as versões mais recentes dos clientes NuGet com um melhor suporte de resiliência.
  • usar variáveis de ambiente de clientes NuGet para aprimorar a política de repetição em máquinas de CI.
Variável de ambiente Descrição Comentários
NUGET_ENABLE_ENHANCED_HTTP_RETRY Habilita ou desabilita a repetição avançada de HTTP no NuGet. Os valores possíveis são true (padrão desde o .NET CLI 6.0.300, NuGet CLI 6.2, Visual Studio 2022 versão 17.2) ou false.
NUGET_ENHANCED_MAX_NETWORK_TRY_COUNT Configura o número máximo de vezes que uma conexão HTTP deve ser tentada novamente quando as novas tentativas avançadas estão habilitadas. Um número que representa quantas novas tentativas executar, o valor padrão é 6.
NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS Configura o tempo para aguardar em milissegundos antes de tentar novamente uma conexão HTTP quando as novas tentativas avançadas estão habilitadas. O número padrão de milissegundos a aguardar, o valor padrão é 1000.

Observação

Essas variáveis de ambiente estão disponíveis desde a CLI do .NET (.NET SDK) 6.0.100, CLI do NuGet 6.0, Visual Studio 2022 versão 17.0 e versão correspondente do MSBuild. Consulte as Notas sobre a versão do NuGet.

Importante

O NuGet.org recomenda que os usuários do Alpine Linux atualizem para o Alpine Linux 3.18.0 ou mais recente. Essas versões são compatíveis com o fallback TCP no resolvedor DNS. Se você usar versões mais antigas do Alpine Linux compatíveis com apenas o DNS no UDP, você poderá encontrar falhas do DNS ao acessar a API V3.

Se essa versão do NuGet continuar falhando, contate o suporte e forneça informações adicionais de solução de problemas de conexão, incluindo:

  • As origens de pacote que você está usando
  • A versão do cliente do NuGet que você está usando
  • Um log de restauração detalhado
  • MTR ou um rastreamento do Fiddler (veja abaixo)
  • Sua área geográfica
  • Se seu computador está por trás de um proxy ou firewall?
  • Se seu computador está localizado no data center dos provedores de nuvem (Azure, AWS etc.)? Se sim, forneça o nome do provedor e a região.

Para capturar MTR:

  • Baixe o WinMTR.

  • Digite api.nuget.org como o nome do host e clique em Iniciar.

  • Aguarde até a coluna Enviado ser >= 100.

    Capturando MTR

  • Copie texto para a área de transferência.

Para capturar o Fiddler:

  • Instale a versão mais recente do Fiddler.
  • Inicie o Fiddler e desabilite a captura de tráfego usando o menu Arquivo > Capturar tráfego.
  • Remova todas as sessões (selecione todos os itens na lista, pressione a tecla Delete).
  • Configure o Fiddler para capturar o tráfego HTTPS marcando Descriptografar tráfego HTTPS na guia HTTPS do menu Ferramentas > Opções do Fiddler....
  • Feche o Visual Studio.
  • Habilite o menu Arquivo > Capturar Tráfego.
  • Inicie o Visual Studio ou .exe do nuget.exe e execute as ações que não estão funcionando. O tráfego gerado por essas ações deve ser exibido no Fiddler.
  • Depois das ações serem executadas, use Arquivo > Salvar > Todas as sessões para armazenar as sessões capturadas.

Observação: pode ser necessário definir a variável de ambiente HTTP_PROXY para http://127.0.0.1:8888 para rotear o tráfego do NuGet através do Fiddler.

Se isso falhar, experimente as dicas mencionadas nesta postagem do StackOverflow.

Gerenciamento de contas do NuGet.org

Como recuperar o logon com senha do NuGet.org?

Observe que o login por senha no NuGet.org foi descontinuado. Infelizmente, o NuGet.org não tem como recuperar contas de senha. Você só poderá fazer logon no NuGet.org com uma conta Microsoft (MSA) pessoal ou uma conta do Azure Active Directory (AAD).

Se não conseguir utilizar o logon da Microsoft, siga os passos para recuperar a sua conta em NuGet.org.

Informe-nos se você precisa de ajuda na transferência de propriedade de seus pacotes para uma conta diferente enviando um email para support@nuget.org.

Qual conta Microsoft está vinculada à minha conta do NuGet.org?

Se você tiver esquecido qual conta Microsoft está associada à sua conta do NuGet.org, siga as etapas abaixo para obter assistência.

  1. Vá para a página de logon do NuGet.org e clique no link Precisa de ajuda para entrar?
  2. Isso mostrará a caixa de diálogo de pop-up para que você obtenha assistência. Siga as etapas nessa caixa de diálogo para entender quais são as contas Microsoft associadas à sua conta do NuGet.org.

Como alterar a conta Microsoft que eu uso para logon no NuGet.org?

Se você quiser alterar a conta Microsoft para o usuário do NuGet.org, siga as etapas abaixo. Digamos que sua conta Microsoft com o email account1@outlook.com esteja associada à conta do NuGet.org com o nome de usuário MyNuGetAccount. É melhor que você altere o logon para outra conta Microsoft com o email account2@outlook.com

  1. Entre usando a conta Microsoft associada atualmente, ou seja, account1@outlook.com na página de logon depois de clicar em Entrar com a conta Microsoft.

  2. Depois de conectado, vá para a página de configurações da conta.

  3. Expanda a seção Conta de Logon. Clique no botão Alterar a Conta.

  4. Agora você será redirecionado à página de logon da Microsoft. Inicie sessão com a conta para a qual deseja alterar a associação, por exemplo, account2@outlook.com. Observação: talvez você precise clicar em Desconectar e iniciar sessão com outra conta durante o fluxo de início de sessão para ser capaz de fazer logon com uma conta Microsoft diferente.

  5. Se você vir um erro como o abaixo, confira A conta Microsoft está vinculada a outra conta do NuGet.org para obter mais detalhes.

    Falha ao atualizar a conta Microsoft com "account2". Isso pode acontecer se ela já está vinculada a outra conta do NuGet. Entre em contato com o suporte para obter mais informações.

  6. Depois que entrar com êxito com sua segunda conta, você será redirecionado para a página de configurações da conta do NuGet.org e deverá ver então a nova conta Microsoft associada como a conta de logon. Prosseguindo, você deverá usar essa conta ao entrar no NuGet.org.

A conta Microsoft está vinculada a outra conta do NuGet.org.

Se você tentou alterar seu logon da Microsoft e viu o erro abaixo:

Falha ao atualizar a conta Microsoft com "account2". Isso pode acontecer se ela já está vinculada a outra conta do NuGet. Entre em contato com o suporte para obter mais informações.

Digamos que você esteja tentando alterar o logon da conta Microsoft de account1@outlook.com para o usuário do NuGet.org com nome de usuário MyNuGetAccount1 para outra conta Microsoft com o email account2@outlook.com. E você vê o erro acima.

**O que o erro acima significa?

Ele significa que há outra conta do NuGet.org associada à conta Microsoft para a qual você está tentando alterá-la, ou seja, no exemplo acima, a conta Microsoft com o email <account2@outlook.com> está associada a outra conta do NuGet.org com, digamos, o nome de usuário MyNuGetAccount2.

Você não pode alterar o logon associado com uma conta Microsoft que está vinculada a outra conta do NuGet.org.

Eu esqueci que tinha outra conta do NuGet.org, como faço para descobrir qual conta do NuGet.org é essa?

Faça logon com a segunda conta Microsoft na página de logon. Isso conectará você à conta do NuGet.org atualmente associada à segunda conta Microsoft. Em seguida, você poderá exibir os pacotes carregados e executar o gerenciamento de conta nessa conta.

Não me importo com essa segunda conta do NuGet.org. Quero alterar meu logon para a primeira conta do NuGet.org com a segunda conta Microsoft. O que devo fazer?

Se você não se importa com a segunda conta do NuGet.org e ainda quer voltar a usar a conta Microsoft associada com o email account2@outlook.com,

pode liberar a associação entre a conta Microsoft e a conta do NuGet.org excluindo esta última.

  1. Siga as etapas para excluir usuário para a segunda conta do NuGet.org MyNuGetAccount2.
  2. Depois que essa conta for excluída, você poderá repetir as etapas para alterar o logon da conta Microsoft.

Espere, eu me preocupo com essa segunda conta também. Eu não quero perder esta conta, apenas alterar meu logons de conta associados à primeira conta.

Você precisará criar/usar uma terceira conta Microsoft, por exemplo, com o email account3@outlook.com.

  1. Primeiro, inicie sessão com sua segunda conta Microsoft, account2@outlook.com, em NuGet.org. Siga as etapas acima para alterar os logons associados e associar a terceira conta Microsoft a essa conta do NuGet.org.
  2. Depois disso, sua segunda conta Microsoft com o email account2@outlook.com estará livre para ser associada à primeira conta do NuGet.org, MyNuGetAccount1. Siga as mesmas etapas acima para alterar os logons da Microsoft para a segunda conta Microsoft.

Entrar com a conta Microsoft mostra que meu email está vinculado a outra conta Microsoft

Se você tiver tentado entrar com sua conta Microsoft, por exemplo, com o email account1@outlook.com, e vir um erro como o mostrado abaixo:

A conta com o email 'account1@outlook.com' está vinculada a outra conta Microsoft.

Se quiser atualizar a conta Microsoft vinculada, você poderá fazer isso na página de configurações de conta.

O que o erro acima significa?

Quando uma conta é criada no NuGet.org, há um endereço de email de comunicação associado a ela. Esse é normalmente o mesmo que o endereço de email usado para a conta Microsoft associada. No entanto, você pode optar por especificar um endereço de email diferente para fins de comunicação. Então, tecnicamente, você pode ter uma conta Microsoft diferente, por exemplo, com account2@outlook.com, que esteja vinculada à conta do NuGet.org que usa o endereço de email de comunicação account1@outlook.com.

Portanto, o erro acima significa que já existe uma conta do NuGet.org com o endereço de email de comunicação account1@outlook.com, mas está associada a outra conta Microsoft com um email diferente de account1@outlook.com.

Como faço para descobrir qual conta Microsoft está vinculada a esta conta do NuGet.org?

Você deve usar o fluxo de assistência de entrada para descobrir qual conta Microsoft está vinculada à conta do NuGet.org com o endereço de email account1@outlook.com.

Não é possível usar o logon da Microsoft. Como faço para recuperar minha conta do NuGet.org?

Se você tentou usar a assistência de início de sessão e não teve acesso à conta Microsoft associada à conta do NuGet.org, entre em contato com o suporte à conta Microsoft.

Como transformar a minha conta do NuGet.org em uma organização?

Se você deseja transformar sua conta em uma organização, siga as etapas descritas na documentação de organizações no nuget.org.

Problemas de logon do NuGet.org para contas do AAD com locatário não gerenciado?

Se você vir um erro como o abaixo durante o fluxo de logon com seu domínio da conta de email (@seudomínio.com), confira as etapas abaixo para recuperar sua conta do NuGet.org.

Erro durante o login para contas do AAD

O que significa estado não gerenciado durante o logon? E por que isso está acontecendo agora?

Sua conta parece ter sido registrada anteriormente como uma conta Microsoft pessoal e isso funcionou bem, no entanto, agora parece que sua conta foi registrada como um locatário "Não gerenciado" no Azure Active Directory (o serviço de identidade que usamos para autenticar contas Microsoft).

Isso pode ter acontecido porque você ou alguém da sua organização (com endereço de email @yourdomain.com) registrou-se com um dos serviços integrados do AAD ou se autoinscreveu no Azure Active Directory, o que cria um locatário "Não gerenciado" para o domínio da conta Microsoft usado (@seudomínio.com no seu caso).

O que posso fazer para recuperar minha conta?

No momento não é possível para nós (NuGet.org) autenticar contas com essas contas de locatário "Não gerenciado" no Azure Active Directory. Estamos buscando autenticar essas contas de uma maneira melhor.

Se quiser fazer logon no NuGet.org com a sua conta Microsoft (@seudomínio.com), você (ou um administrador da sua empresa) precisará se declarar proprietário do AAD fazendo uma validação de DNS para autenticar usuários com o endereço de email "@seudomínio.com". Siga as etapas para tomada de controle do administrador de domínios documentadas pelo Azure Active Directory. Depois que isso for feito, seu logon normal deverá começar a funcionar.

Como faço para alterar meu nome de usuário da conta do NuGet.org?

Você pode solicitar uma alteração de nome de usuário enviando um email para support@nuget.org do endereço de email vinculado à conta que deseja atualizar. Certifique-se de incluir o nome de usuário antigo e o novo nome de usuário para o qual você gostaria de alterar. Em seguida, analisaremos sua solicitação e, após a aprovação, obteremos a confirmação de que estamos prestes a tomar as medidas corretas e que você entende as consequências. Após sua confirmação, alteraremos seu nome de usuário.

Importante

  • O nome de usuário antigo ainda permanecerá reservado. Você não poderá reutilizar o mesmo nome de usuário novamente e isso inclui a variações no uso de maiúsculas e minúsculas.
  • Como consequência, também não poderemos reverter essa mudança.
  • Quaisquer links para sua página de perfil do nome de usuário antigo (por exemplo, https://www.nuget.org/profiles/OldUsername) não serão redirecionados para seu novo perfil.
  • As versões do pacote que pertencem à sua conta no momento ainda conterão o nome de usuário antigo na assinatura do repositório. As novas versões do pacote conterão o novo nome de usuário.
  • Os metadados fornecidos pelo autor nas versões existentes de pacotes referentes ao nome de usuário antigo ou outras informações de identificação não serão alterados.
  • As políticas de cliente do NuGet que declaram a confiança em seu nome de usuário antigo não confiarão implicitamente em pacotes publicados por seu novo nome de usuário. Os consumidores de pacotes com essas políticas de cliente configuradas precisarão atualizá-las manualmente para confiar em seu novo nome de usuário quando tentarem atualizar para uma versão de pacote recém-publicada.

Como faço para excluir minha conta do NuGet.org?

Para excluir sua conta, recomendamos que você transfira a propriedade de todos os pacotes dos quais você é o único proprietário. Você pode ler mais sobre como fazê-lo em gerenciamento dos proprietários de pacote. Isso também ajuda a agilizar sua solicitação.

Se você pretende transformar sua conta em uma organização, siga as etapas fornecidas em Transformar minha conta do NuGet.org em uma organização.

Importante

Excluir o usuário resultará no seguinte:

  1. Seu nome de usuário será reservado e ninguém poderá usá-lo novamente para criar uma conta individual ou uma conta da organização
  2. Revoga as chaves de API associadas.
  3. Remova a conta como um proprietário de quaisquer pacotes filho.
  4. Desassocie todas as reservas de prefixo de ID existentes anteriormente com esta conta.
  5. Remova a conta como um membro de quaisquer organizações.

Siga as etapas a seguir para continuar com a exclusão da conta.

  1. Faça logon no NuGet.org com a conta que você deseja excluir.
  2. Clique nesta URL: https://www.nuget.org/account/delete e siga as etapas para enviar a solicitação para excluir a conta.

Nosso atendimento ao cliente processará essa solicitação e executará a exclusão da conta.

O que acontece à minha conta NuGet.org quando a minha conta Microsoft é excluída?

Quando a conta Microsoft ou a conta do Azure Active Directory que você usa para entrar em sua conta do nuget.org for excluída, sua conta nuget.org também será excluída. A ação de exclusão de conta é concluída pelo suporte ao cliente do nuget.org dentro de 30 dias a partir da data da exclusão da conta Microsoft.

Se você tiver pacotes associados à sua conta, notificaremos você 3 dias úteis antes de prosseguir com a exclusão e ofereceremos assistência para transferir os pacotes para uma conta nuget.org diferente.