Partilhar via


NuGet.org perguntas frequentes

Termos de licenciamento

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 que estão incluídos no pacote. Deve rever os termos aplicáveis antes de aceder, transferir ou adquirir quaisquer pacotes. No NuGet.org, use o link Informações da licença na página do pacote.

Se um pacote não especificar os termos de licenciamento, entre em contato diretamente com o proprietário do pacote usando o link Contatar proprietários na página NuGet.org pacote. A Microsoft não licencia qualquer propriedade intelectual ao Cliente de fornecedores de pacotes de terceiros e não é responsável pelas informações fornecidas por terceiros.

Gerenciando pacotes no NuGet.org

Posso editar os metadados do pacote depois de carregados?

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, o que inclui o nuspec. A edição dos metadados do pacote resulta em alterações no nuspec, invalidando assinaturas existentes. Recomendamos modificar os fluxos de trabalho existentes para não exigir a edição dos metadados do pacote após a criação do pacote.

Observe que as dependências listadas para seu pacote são geradas automaticamente a partir 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 disponibilizar um pacote na galeria pública. Ponto de extremidade da API: https://apiint.nugettest.org/v3/index.json

Posso excluir um pacote publicado no NuGet.org?

Em geral, não suportamos a exclusão de um pacote publicado para 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 pacotes no NuGet.org solicitando um prefixo de ID de pacote para sua conta. Para solicitar um prefixo de ID de pacote, siga as instruções na documentação.

Como faço para reivindicar a propriedade dos pacotes?

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

Incentivamos a comunidade NuGet a trabalhar em conjunto para resolver quaisquer disputas que possam surgir entre os proprietários dos pacotes e os proprietários de outros softwares. Criámos um processo de resolução de litígios a seguir antes de pedir aos administradores NuGet.org que intercedam.

Recomenda-se carregar os meus pacotes de teste para NuGet.org?

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

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

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

NuGet.org permite pacotes de até 250 MB, mas recomendamos manter os pacotes abaixo de 1 MB, se possível, e usar dependências para vincular pacotes. Como regra geral, os pacotes contêm apenas um conjunto para evitar colisões.

O NuGet usa HTTP para baixar pacotes, portanto, pacotes maiores têm uma probabilidade maior de falhas nas instalações do que os menores.

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

As dependências são, na sua maioria, estáticas e nunca mudam. Ao corrigir um bug no código, as dependências podem não precisar ser atualizadas. Se você agrupar dependências, você acaba reenviando pacotes maiores toda vez. Ao dividir os pacotes NuGet em dependências relacionadas, as atualizações são muito mais refinadas para os consumidores do seu pacote.

NuGet.org não acessível

Que versão SSL/TLS e pacotes de codificação NuGet.org suporta?

NuGet.org suporta TLS 1.2 e os seguintes pacotes 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 do NuGet.org, sugerimos:

  • usar as versões mais recentes dos clientes NuGet com um melhor suporte de resiliência.
  • use 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 Observações
NUGET_ENABLE_ENHANCED_HTTP_RETRY Habilita ou desabilita a repetição de HTTP aprimorada no NuGet. Os valores possíveis são true (padrão desde .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 repetida quando novas tentativas avançadas são habilitadas. Um número que representa quantas tentativas repetidas executar, o valor padrão é 6.
NUGET_ENHANCED_NETWORK_RETRY_DELAY_MILLISECONDS Configura a quantidade de tempo de espera em milissegundos antes de tentar novamente uma conexão HTTP quando as novas tentativas avançadas estão habilitadas. Número de millseconds a esperar, o valor padrão é 1000.

Observação

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

Importante

NuGet.org recomenda que os usuários do Alpine Linux atualizem para o Alpine Linux 3.18.0 ou mais recente. Estas versões suportam fallback TCP no resolvedor de DNS. Se você usa versões mais antigas do Alpine Linux que suportam apenas DNS sobre UDP, você pode encontrar falhas de DNS ao acessar a API V3.

Se essa versão do cliente NuGet continuar a falhar, entre em contato com o suporte e forneça informações adicionais de solução de problemas de conexão, incluindo:

  • !!! A sua área geográfica
  • As fontes de pacote que você está usando
  • A versão do cliente NuGet que você está usando
  • Um log de restauração com detalhado detalhamento
  • Traços MTR ou Fiddler (ver abaixo)
  • Se a sua máquina está atrás de um proxy ou firewall?
  • Sua máquina está localizada no data center de um provedor de nuvem (Azure, AWS, etc)? Em caso afirmativo, indique o nome do prestador e a região.

Para capturar MTR:

  • Baixar WinMTR.

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

  • Aguarde até que a coluna Enviado seja >= 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 desative a captura de tráfego usando o menu Tráfego de captura de arquivos>.
  • Remova todas as sessões (selecione todos os itens na lista, pressione a tecla Delete ).
  • Configure o Fiddler para capturar 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 Tráfego de captura de arquivos>.
  • Inicie o Visual Studio ou nuget.exe .exe e execute as ações que não estão funcionando. O tráfego gerado por essas ações deve aparecer no Fiddler.
  • Depois que as ações forem executadas, use Arquivo > Salvar > Todas as Sessões para armazenar as sessões capturadas.

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

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

NuGet.org gestão de contas

Como recuperar NuGet.org senha de login?

Tenha em atenção que o início de sessão com NuGet.org palavra-passe foi descontinuado. Infelizmente, NuGet.org não tem como recuperar contas de senha, você só pode fazer logon no NuGet.org com uma conta pessoal da Microsoft (MSA) ou uma conta do Azure Ative Directory (AAD).

Se não conseguir utilizar o início de sessão da Microsoft, siga os passos para recuperar a sua conta NuGet.org.

Por favor, informe-nos se precisar de ajuda para transferir a propriedade dos seus pacotes para uma conta diferente, enviando um e-mail para support@nuget.org.

Que conta Microsoft está associada à minha conta NuGet.org?

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

  1. Vá para NuGet.org página de login e clique no link Precisa de assistência para entrar?
  2. Isso mostrará a caixa de diálogo pop-up para obter assistência. Siga os passos nesta caixa de diálogo para compreender a(s) conta(s) Microsoft(s) associada(s) à sua conta NuGet.org.

Como posso alterar a conta Microsoft que utilizo para iniciar sessão NuGet.org?

Se pretender alterar a conta Microsoft para NuGet.org utilizador, siga os passos abaixo. Digamos que a sua conta Microsoft com e-mail account1@outlook.com está associada à sua conta NuGet.org com nome MyNuGetAccountde utilizador . Pretende alterar o início de sessão para outra conta Microsoft com correio eletrónico account2@outlook.com

  1. Inicie sessão utilizando a conta Microsoft atualmente associada , ou seja account1@outlook.com , na página de início de sessão depois de clicar em Iniciar sessão com a Microsoft.

  2. Depois de iniciar sessão, aceda à página de definições da sua conta .

  3. Expanda a seção para Conta de login. Clique no botão Alterar conta .

  4. Agora você será redirecionado para a página de login da Microsoft. Por favor, inicie sessão com a conta para a qual deseja alterar a associação, ou seja, account2@outlook.com. Nota: poderá ter de clicar em Terminar sessão e iniciar sessão com uma conta diferente durante o fluxo de início de sessão para poder iniciar sessão com uma conta Microsoft diferente.

  5. Se vir um erro como abaixo, consulte A conta Microsoft está associada a outra conta NuGet.org para obter mais detalhes.

    Falha ao atualizar a conta da Microsoft com 'account2 account2@outlook.com'. Isso pode acontecer se ele já estiver vinculado a outra conta NuGet. Entre em contato com o suporte para obter mais informações.

  6. Depois de iniciar sessão com êxito com a sua segunda conta, será redirecionado de volta para a página de definições da sua conta NuGet.org e deverá agora ver a nova conta Microsoft associada como conta de início de sessão. No futuro, você deve usar essa conta ao entrar no NuGet.org.

A conta Microsoft está associada a outra conta NuGet.org.

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

Falha ao atualizar a conta da Microsoft com 'account2 account2@outlook.com'. Isso pode acontecer se ele já estiver vinculado a outra conta NuGet. Entre em contato com o suporte para obter mais informações.

Digamos que estava a tentar alterar o início de sessão da conta Microsoft de NuGet.org utilizador com nome MyNuGetAccount1 de account1@outlook.com utilizador para outra conta Microsoft com correio eletrónicoaccount2@outlook.com. E você vê o erro acima.

**O que significa o erro acima?

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

Não é possível alterar o início de sessão associado a uma conta Microsoft associada a uma conta NuGet.org diferente.

Esqueci-me que tinha outra conta NuGet.org, como posso descobrir qual é a NuGet.org conta?

Inicie sessão com a segunda conta Microsoft na página início de sessão. Isto irá iniciar sessão na conta NuGet.org que está atualmente associada à segunda conta Microsoft. Em seguida, você pode visualizar os pacotes carregados e executar o gerenciamento de conta nessa conta.

Não me importo com esta segunda conta NuGet.org, quero alterar o meu início de sessão para a primeira conta NuGet.org com a segunda conta Microsoft. O que faço eu?

Se você deseja não se importar com a segunda conta NuGet.org e ainda deseja reutilizar a conta da Microsoft associada com email account2@outlook.com.

Você pode liberar a associação entre a conta da Microsoft e NuGet.org conta excluindo a conta NuGet.org.

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

Espere, eu me importo com esta segunda conta também. Não quero perder esta conta, mas alterar os logins da minha conta associada para a primeira conta.

Você precisará criar/usar uma terceira conta da Microsoft, digamos, com email account3@outlook.com.

  1. Primeiro, deve iniciar sessão com a sua segunda conta Microsoft, account2@outlook.com em NuGet.org. Siga os passos acima para alterar os inícios de sessão associados e associar a terceira conta Microsoft a esta conta NuGet.org.
  2. Uma vez feito, sua segunda conta da Microsoft com email account2@outlook.com é livre para ser associada à sua primeira conta NuGet.org, MyNuGetAccount1. Siga os mesmos passos acima para alterar os inícios de sessão da Microsoft para a segunda conta Microsoft.

Iniciar sessão com a conta Microsoft mostra-me que o meu e-mail está associado a outra conta Microsoft

Se tentou iniciar sessão com a sua conta Microsoft, por exemplo, com correio eletrónico account1@outlook.com e vir um erro como o abaixo:

A conta com e-mail 'account1@outlook.com' está vinculada a outra conta da Microsoft.

Se pretender atualizar a conta Microsoft associada, pode fazê-lo a partir da página de definições da conta.

O que significa o erro acima?

Quando uma conta é criada no NuGet.org, há um endereço de e-mail de comunicação associado a essa conta. Isso geralmente é o mesmo que o endereço de email usado para a conta da Microsoft associada. No entanto, você pode optar por especificar um endereço de e-mail diferente para comunicação. Então, tecnicamente, você poderia ter uma conta da Microsoft diferente, digamos que está account2@outlook.com vinculada a NuGet.org conta com endereço de email de comunicação como account1@outlook.com.

Portanto, o erro acima significa que já existe NuGet.org conta com endereço account1@outlook.com de email de comunicação, mas está associada a outra conta da Microsoft com email que nãoaccount1@outlook.com é.

Como posso encontrar a conta Microsoft que está associada a esta conta NuGet.org?

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

Não consigo utilizar o início de sessão da Microsoft, como posso recuperar a minha conta NuGet.org?

Se tentou utilizar a assistência de início de sessão e não tem acesso à conta Microsoft associada à sua conta NuGet.org, contacte o suporte da sua conta Microsoft:

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

Se você quiser transformar sua conta em uma organização, siga as etapas fornecidas na documentação para organizações em nuget.org.

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

Se vir um erro como abaixo durante o seu fluxo de início de sessão com a sua conta de e-mail domain(@yourdomain.com), consulte os passos abaixo para recuperar a sua conta NuGet.org.

Erro durante o login para contas do AAD

O que é essa coisa de estado não gerenciado durante o login? E por que isso está acontecendo agora?

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

Isso poderia ter acontecido se você ou alguém da sua organização (com @yourdomain.com endereço de email) se registrasse em um dos serviços integrados do AAD ou fizesse uma inscrição de autoatendimento para o Azure Ative Directory, que cria um locatário "Não gerenciado" para a conta da Microsoft usada domain(@yourdomain.com no seu caso).

O que posso fazer para recuperar a minha conta?

Neste momento, não há uma maneira de (NuGet.org) autenticar contas com essas contas de locatário "Não gerenciadas" no Ative Directory do Azure. Estamos procurando uma maneira melhor de autenticar essas contas.

Se você quiser fazer login no NuGet.org com seu account(@yourdomain.com Microsoft, você (ou um administrador da sua empresa) precisará reivindicar a propriedade do AAD fazendo uma validação de DNS para autenticar usuários com o endereço de email "@yourdomain.com". Siga as etapas para a aquisição de administradores de domínios documentada pelo Ative Directory do Azure. Uma vez feito isso, seu login normal deve começar a funcionar.

Como posso alterar o nome de utilizador da minha conta NuGet.org?

Você pode solicitar uma alteração de nome de usuário enviando um e-mail para support@nuget.org o endereço de e-mail anexado à conta que você deseja atualizar. Certifique-se de incluir o nome de usuário antigo e o novo nome de usuário que você gostaria de alterar. Em seguida, analisaremos o seu pedido e, após aprovação, obteremos a confirmação de que estamos prestes a tomar as medidas corretas e que compreende as consequências. Assim que tiver confirmado, alteraremos o seu nome de utilizador.

Importante

  • O nome de usuário antigo ainda será reservado. Você não poderá reutilizar o nome de usuário antigo novamente e isso inclui a mudança de invólucros.
  • Como consequência do acima exposto, também não poderemos reverter esta alteração.
  • Quaisquer links para a sua página de perfil de nome de utilizador antigo (por exemplo https://www.nuget.org/profiles/OldUsername) não serão redirecionados para o seu novo perfil.
  • As versões de pacotes atualmente pertencentes à sua conta 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.
  • Quaisquer metadados fornecidos pelo autor nas versões existentes do pacote referentes ao nome de usuário antigo ou outras informações de identificação não serão alterados.
  • As políticas de cliente NuGet que declaram confiança em seu nome de usuário antigo não confiarão implicitamente nos pacotes publicados pelo 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 eliminar a minha conta NuGet.org?

Para eliminar a sua conta, tenha em atenção que recomendamos que transfira a propriedade de quaisquer pacotes em que seja o único proprietário. Você pode ler mais sobre como gerenciar proprietários de pacotes sobre como fazer isso. Isso também nos ajudará a agilizar o seu pedido.

Se você está procurando transformar sua conta em uma organização, siga as etapas dadas em transformar minha conta NuGet.org em uma organização.

Importante

A exclusão do usuário resultará no seguinte:

  1. O seu nome de utilizador será reservado e ninguém poderá reutilizá-lo para criar uma conta individual ou uma conta de organização
  2. Revogar chave(s) de API associada(s).
  3. Remova a conta como proprietário de todos os pacotes filho.
  4. Dissocie todas as reservas de prefixo de ID existentes anteriormente com esta conta.
  5. Remova a conta como membro de qualquer organização.

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

  1. Inicie sessão para NuGet.org com a conta que pretende eliminar.
  2. Clique neste url: https://www.nuget.org/account/delete e siga os passos para submeter o pedido de eliminação da conta.

O nosso apoio ao cliente irá processar este pedido e realizar a eliminação da conta.

O que acontece à minha conta NuGet.org quando a minha conta Microsoft é eliminada?

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

Se tiver pacotes associados à sua conta, iremos notificá-lo 3 dias úteis antes de proceder à eliminação e ofereceremos assistência para transferir os pacotes para uma conta nuget.org diferente.