Configuración de un repositorio GitSetting up a Git repository

Git es un sistema de control de versiones distribuido que permite a los equipos trabajar en los mismos documentos de forma simultánea.Git is a distributed version control system that allows teams to work on the same documents simultaneously. Esto significa que hay un único servidor que contiene todos los archivos, pero que cada vez que se extrae un repositorio de este origen central, la totalidad del repositorio se clona localmente en el equipo del usuario.This means that there is a single server that contains all the files, but whenever a repository is checked out from this central source, the entire repository is cloned locally to your machine.

Hay muchos hosts remotos que permiten trabajar con Git para el control de versiones, aunque el más común de estos es GitHub.There are many remote hosts that allow you to work with Git for version control, however the most common of these is GitHub. En el ejemplo siguiente se usa un host de GitHub, pero puede usar cualquier host de Git para el control de versiones en Visual Studio para Mac.The example below uses a GitHub host, but you can use any Git host for version control in Visual Studio for Mac.

Si quiere usar GitHub, asegúrese de haber creado y configurado una cuenta antes de seguir los pasos siguientes.If you wish to use GitHub, ensure that you have an account created and configured before following the steps below.

Creación de un repositorio remoto en GitHubCreating a remote repo on GitHub

En el ejemplo siguiente se usa un host de GitHub, pero puede usar cualquier host de Git para el control de versiones en Visual Studio para Mac.The example below uses a GitHub host, but you can use any Git host for version control in Visual Studio for Mac.

Para configurar un repositorio Git, ejecute los siguientes pasos:To set up a Git repository, execute the following steps:

  1. Cree un nuevo repositorio Git en github.com:Create a new Git repo at github.com:

    Creación de un nuevo repositorio Git

  2. Defina el nombre, la descripción y la privacidad del repositorio.Set Repo Name, description, and privacy. No inicialice el repositorio.Do not initialize Repo. Establezca .gitignore y la licencia en None:Set .gitignore and license to None:

    Establecimiento de los detalles del repositorio Git

  3. La siguiente ubicación le proporciona una opción para mostrar y copiar la dirección HTTPS o SSH en el repositorio que acaba de crear:The next place will give you an option to display and copy either the HTTPS or SSH address to the repo you have just created:

    Ver y copiar la dirección Necesitará la dirección HTTPS para dirigir Visual Studio para Mac a este repositorio.view and copy address You will need the HTTPS address to point Visual Studio for Mac to this repo.

Publicación de un proyecto existentePublishing an existing project

  1. Vuelva al proyecto abierto en Visual Studio para Mac.Return to your open Project in Visual Studio for Mac.

  2. En la barra de menús, seleccione Control de versiones > Publicar en Control de versiones...:In the Menu bar, select Version Control > Publish in Version Control…:

    Iniciar la extracción del repositorio en Visual Studio para Mac

  3. Esto mostrará el cuadro de diálogo Seleccionar repositorio.This will display the Select Repository dialog. Elija la pestaña Repositorios registrados y haga clic en el botón Agregar:Choose the Registered Repositories tab and press the Add button:

  4. Escriba el nombre del repositorio tal y como quiera que se muestre localmente y pegue la dirección URL del paso 3.Enter the name of the repository as you would like it to display locally, and paste in the URL from step #3. El cuadro de diálogo Configuración del repositorio debería tener un aspecto similar al siguiente.Your Repository Configuration dialog should look similar to the following. Haga clic en Aceptar:Press OK:

    Especificación en el cuadro de diálogo de detalles de Git

    Tenga en cuenta que también es posible usar SSH para conectarse a Git.Note that it is also possible to use SSH to connect to Git.

  5. Para intentar publicar la aplicación en Git, seleccione el repositorio que acaba de crear y asegúrese de que se han rellenado los campos de texto Nombre del módulo y Mensaje:To attempt to publish the app to Git, select the repository just created, and ensure that both Module Name and Message text fields are completed:

    Intento de publicación del proyecto en Git

  6. Haga clic en Aceptar y luego en Publicar en el cuadro de diálogo de alerta.Click Okay, and then Publish from the alert dialog.

  7. Si aún no ha escrito las credenciales de Git en las preferencias de Visual Studio para Mac, hágalo ahora.If you have not already entered your Git credentials in Visual Studio for Mac preferences, enter them now. En primer lugar debe crear un token de acceso, que se usa en lugar de una contraseña.First, you need to create an Access Token, which is used in place of a password. Para ello, siga los pasos de la documentación de Git Token de acceso.Follow the steps in the Git Access Token documentation to do this.

  8. Escriba el nombre de usuario y el token de acceso personal y haga clic en Aceptar:Enter the username and Personal Access Token, and press Okay:

    Especificación del nombre de usuario y la contraseña de Git

  9. Pasados unos segundos, la solución debe publicarse con su confirmación inicial.After a few seconds, the Solution should be published with its inital commit. Confírmelo en el elemento de menú Control de versiones, que ahora debería contener muchas opciones:Confirm this by browsing the Version Control menu item, which should now be populated with many options:

    Menú Control de versiones

  10. Cuando empiece a realizar otros cambios, seleccione Insertar cambios... para enviar los cambios realizados al repositorio remoto.Once you start to make additional changes select Push Changes... to push the changes to the remote repository. Esto permitirá a todos los usuarios adecuados verlo en github.com:This will allow all appropriate users to view it on github.com:

    Enviar cambios al repositorio remoto

Publicación de un proyecto nuevoPublishing a new project

El cuadro de diálogo Nuevo proyecto puede usarse para publicar un proyecto nuevo con Git.The new project dialog can be used to publish a new project using git. Para habilitarlo, active la casilla Usar Git para el control de versiones,To enable it, select the Use git for version control. como se muestra en la captura de pantalla siguiente.checkbox, as illustrated in the following screenshot. Esto inicializará el repositorio y agregará un archivo .gitignore opcional:This will initialize your repo and add an optional .gitignore file:

Enviar cambios al repositorio remoto

Desproteger un repositorio existenteCheckout an existing repository

Es muy probable que tenga que trabajar con un repositorio de GitHub que existe solo en el equipo remoto y no en el equipo local.It's very likely that you'll have to work with a GitHub repo that exists only on the remote, not on your local machine. Visual Studio para Mac permite desproteger este repositorio rápidamente.Visual Studio for Mac allows you to checkout this repo quickly. Siga estos pasos para clonarlo en el equipo:Follow the steps below to clone it to your machine:

  1. En la barra de menús, seleccione Control de versiones > Desproteger... :In the Menu bar, select Version Control > Checkout…:

  2. Se mostrará la pestaña Conectar a repositorio:This displays the Connect to Repository tab:

    Pestaña Conectar a repositorio con detalles especificados

  3. En la página de GitHub del repositorio remoto, presione el botón Clonar o descargar y copie la URL proporcionada:On the GitHub page of the remote repository, press the Clone or Download button and copy the URL provided:

    url de github mostrada

  4. Reemplace todo el texto del campo de entrada de la URL en la pestaña Conectar a repositorio. Se rellenarán automáticamente la mayoría de los campos de la pestaña, como se muestra en la imagen del paso 2.Replace all the text in the URL entry field in the Connect to Repository tab. This will populate most other fields in this tab for you, as illustrated in the image in step #2.

  5. Escriba el directorio en el que quiere clonar el repositorio y presione Desproteger.Enter the directory that you want to clone the repo into and press Checkout.

Nota

Puede que tenga problemas si el repositorio tiene más de 4 GB.You may experience issues if the repo is over 4GB in size.

Solución de problemasTroubleshooting

Si tiene problemas para inicializar el proyecto con un repositorio remoto vacío, pruebe a seguir estos pasos:If you have issues with initializing your project with an empty remote repository, you can try the following steps:

  • Vaya a la carpeta de la solución.Go to your solution folder.
  • Presione Command + Shift + . para mostrar los archivos y las carpetas ocultos.Press Command + Shift + . To show the hidden files and folders.
  • Si hay una carpeta .git, elimínela.If there's a .git folder, delete it.
  • Si hay un archivo gitignore, elimínelo.If there's a gitignore file, delete it.
  • Presione Command + Shift + . para ocultar los archivos y las carpetas.Press Command + Shift + . To hide the files and folders.
  • Abra la solución en VS para Mac.Open your solution in VS for Mac.
  • En el panel de la solución, seleccione el nodo de esta.On the solution pad, select your solution node.
  • Vaya al menú Control de versiones y elija Publicar en Control de versiones.Browse to the Version Control menu and choose Publish in Version Control.
  • Siga los pasos del tutorial anterior a partir del paso 6.Follow the steps of the above tutorial starting from the step 6.