Xcode es la herramienta que usan los desarrolladores en la construcción de apps para el ecosistema Apple – MacOS, iOS, y todo lo relacionado con Apple.

Esta guía te explicará cómo instalar Xcode en tu Mac exitosamente, de principio a fin.

Aquí van algunos tips útiles de conocer antes de empezar:

• Xcode solo corre en un mac. Si estás en un PC, desafortunadamente no podrás usar Xcode.
• Requerirás una conexión a internet buena y estable. La versión más reciente tiene un tamaño de alrededor de 8 gigabytes.
• Asegúrate de tener al menos 30 gigabytes de espacio libre en tu computadora. La versión más reciente del archivo .xip  (versión 14.0.1 al momento de escritura) es de aproximadamente 8 gigabytes comprimidos. Cuando lo descomprimes, van otros 17 gigabytes. Luego necesitarás la herramienta de línea de comando, que serían otros 1.5 gigabytes.

Aquí va un resumen de los pasos para instalar Xcode

1. Descarga Xcode
2. Instala la herramienta de línea de comandos
3. Abre la nueva versión
4. Elimina archivos

Nota que he listado algunos comandos de Terminal en los pasos de abajo. Estos comandos pueden escribirse en tu directorio de trabajo actual. Esto significa que no tienes que navegar hacia ninguna carpeta en particular.

Si realmente deseas hacerlo, primero puedes escribir cd antes de ingresar los comandos de los pasos de abajo. Esto te regresará a tu carpeta home.

Paso #1: Descarga Xcode

Existen dos maneras de hacer esto. Para la versión más reciente y una instalación "sencilla" en teoría, puedes usar la App Store. No recomiendo esta opción.

Prefiero usar el sitio de desarrolladores. De esta manera, tendrás la opción de descargar cualquier versión que desees.

Opción #1: Descargar a través de la App Store la versión más reciente (no es mi opción de preferencia)

En teoría, este debería ser un proceso sencillo y sin complicaciones mayores. Pero, si por cualquier motivo la instalación falla en el último paso, se hace muy difícil de solucionar.

Existen varias razones para que ocurra este fallo, y ninguna manera fácil de determinar cuál de ellas es la causa. Si te llegas a encontrar con un fallo, tendrás que descargar el archivo completo de nuevo cada vez que intentes repararlo. Dado que la última versión es de 8 gigabytes, no disfruté mucho esta ruta.

Pero si te sientes valiente, aquí van los pasos:

• Abre la App Store en tu mac
• Inicia sesión
• Busca Xcode
• Haz clic en instalar o actualizar

Opción 2: Descargar a través del sitio del desarrollador para una versión específica (mi opción preferida)

1. Dirígete a la sección "More" de la página de descargas del sitio web para desarrolladores de Apple.
2. Inicia sesión con tú id de cuenta de iTunes
3. Ingresa la versión que te gustaría, y descarga el archivo Xcode_x_x_x.xip. Ten en cuenta que Xcode 14.0.1 es de 7 gigabytes, así que esto tomará un tiempo dependiendo de tu conexión a internet.
4. Una vez descargado el archivo, haz clic en .xip para extraerlo. Tu computadora lo extraerá a la misma carpeta en que lo descargaste. Este proceso de extracción es automático. No tienes que hacer nada más después de hacer clic en el archivo .xip. Este paso tardará unos minutos.
5. [Opcional] Una vez extraído, cambia el nombre de la aplicación a “Xcode14.x.x” si estás usando múltiples versiones.
6. Arrastra la aplicación a la carpeta de Aplicaciones.
7. [Opcional] Establece la nueva versión de Xcode como la predeterminada. Abre Terminal y escribe sudo xcode-select -switch /Applications/Xcodex.x.x.app . Reemplaza x.x.x con el número de la versión. Por ejemplo: Xcode14.0.1.app. Tendrás que ingresar tu contraseña de administrador. Estoy bastante segura que esto actualizará la versión predeterminada de Xcode para todos los usuarios de tu computador, así que es mejor que preguntes a los otros usuarios antes de hacerlo.

Paso #2: Instala la herramienta de línea de comandos (HLC)

Si tienes varios usuarios en tu computadora, tendrás que actualizar la HLC para cada uno.

Descargar .dmg

Para actualizar la HLC, ve al sitio de desarrollador y descarga el .dmg de la herramienta de línea de comandos .dmg.

Si nunca has instalado Xcode antes, quizás puedas actualizar desde tu Terminal, escribiendo xcode-select --install en vez de visitar el sitio web del desarrollador.

Pero si tienes una versión existente de Xcode instalada en tu máquina, probablemente obtendrás este error:

xcode-select: error: command line tools are already installed, use “Software Update” to install updates

Esto significa que tendrás que hacerlo desde el sitio de desarrollador.

Instalando la HLC

Cuando el .dmg termine la descarga, haz doble clic sobre el archivo para abrirlo. Esto abrirá una pequeña ventana que luce así:

Doble clic sobre la caja y sigue las instrucciones para instalar la HLC. Tardará unos minutos en completarse.

Puede ser que al final de la instalación se te pregunte si deseas mover este archivo a la papelera. Cuando esto ocurre, se refiere a mover el archivo  .dmg  a la papelera. Como ya no voy a necesitar este archivo, siempre le indico que sí lo haga.

Paso #3: Abre Xcode

Abre la carpeta de Aplicaciones y abre la nueva versión de Xcode. Si renombraste Xcode, asegúrate de abrir la aplicación correcta.

Puede ser que Xcode te solicite instalar componentes adicionales. Haz clic en Instalar. Esto tardará unos minutos.

Mientras se da la instalación, verifica que tu versión predeterminada de Xcode es la que acabas de descargar:

• Abre Terminal
• Escribe brew config
• Podrás ver las versiones de "CLT" (HLC) y "Xcode", asimismo todo lo demás. Esto debería reflejar la versión que acabas de descargar. En mi caso, descargué Xcode 11.4.1.

CLT: 11.4.1.0.1.1586360307
Xcode: 11.4.1 => /Applications/Xcode11.4.1.app/Contents/Developer

Una vez instalados los componentes, se ejecutará Xcode. Ahora podrás retomar tus antiguos proyectos y continuar desde donde los dejaste sin problema alguno*.

*Nota que si usas herramientas de proxy, como Charles, tendrás que reinstalar esos certificados en tu simulador de nuevo.

Si te encuentras con errores mientras intentas compilar o ejecutar un proyecto, revisa qué dispositivo estás tratando de ejecutar. Puede ser que la nueva versión no recuerde el dispositivo que estabas usando antes. Si es así, haz clic sobre el dispositivo y selecciona "Añadir simuladores adicionales" del menú desplegable para añadir el dispositivo que desees.

Paso #4. Elimina los archivos

Si no necesitas las versiones más antiguas de Xcode en tu computador, puedes desinstalarlos y liberar algo de espacio en tu disco.

También puedes eliminar el archivo .xip de la versión que acabas de descargar, así como el archivo CLT.dmg.

Eso es todo. Espero que esto te haya ayudado a instalar Xcode exitosamente. ¡Diviértete!

Hace algunos meses, decidí lanzar Caer, un paquete de Visión Artificial disponible en Python. El proceso fue extremadamente difícil. Podrás adivinar la razón - poca (y confusa) documentación, falta de buenos tutoriales, y demás.

Así que decidí escribir este artículo con la esperanza de que ayude a otras personas que estén teniendo dificultades en hacer esto. Vamos a construir un módulo muy simple y ponerlo a disposición de todo el mundo.

Los contenidos de este módulo siguen una estructura muy básica. Hay, en total, cuatro archivos de Python, cada uno de los cuales contiene solamente un método. Vamos a mantenerlo simple por ahora.

base-modulomuysimple  --> Base
└── modulomuysimple   --> Módulo Actual
    ├── extras
    │   ├── multiplica.py
    │   ├── divide.py
    ├── suma.py
    ├── resta.py

Vas a notar que tengo una carpeta llamada modulomuysimple que a su vez, contiene dos archivos de Python suma.py y resta.py. También hay una carpeta llamada extras (que contiene a multiplica.py y divide.py). Esta carpeta será la base de nuestro módulo de Python.

Sacando los __init__s

Algo que encontrarás en cualquier paquete de Python es un archivo __init__.py. Este archivo le dirá a Python que trate los directorios como módulos (o submódulos).

Dicho de manera simple, va a contener los nombres de todos los métodos de todos los archivos de Python que estén en su directorio inmediato.

Un archivo __init__.py típico tiene el siguiente formato:

from archivo import metodo 

# 'metodo' es una función que se encuentra en un archivo llamado 'archivo.py'

Al construir paquetes en Python, se requiere añadir un archivo __init__.py dentro de cada subdirectorio del paquete. Estos subdirectorios son los submódulos de tu paquete.

Para nuestro caso, añadiremos nuestros archivos __init__.py al directorio del 'módulo real' modulomuysimple, de esta manera:

from suma import suma
from resta import resta

y haremos lo mismo para la carpeta  extras, así:

from multiplica import multiplica
from divide import divide

Una vez hecho esto, ¡prácticamente estaremos a mitad del camino!

Cómo configurar setup.py

Dentro de la carpeta base-modulomuysimple (y en el mismo directorio que nuestro módulo modulomuysimple), tendremos que añadir un archivo setup.py. Este archivo es esencial si tu intención es crear el módulo real en cuestión.

Nota: Siéntete libre de nombrar el archivo setup.py como desees. Este archivo no es de denominación específica como sí lo es nuestro archivo  __init__.py.

Algunas opciones de nombre posibles son setup_mi_super_genial_paquete_python.py y paquete_python_setup.py, pero suele ser mejor práctica quedarse con setup.py.

El archivo setup.py va a contener información acerca de tu paquete, específicamente el nombre del paquete, su versión, dependencias y un montón de cosas más.

Para nuestros propósitos, no vamos a requerir metainformación avanzada, así que el siguiente código debería ajustarse a la mayoría de paquetes que construyas:

from setuptools import setup, find_packages

VERSION = '0.0.1' 
DESCRIPTION = 'Mi primer paquete de Python'
LONG_DESCRIPTION = 'Mi primer paquete de Python con una descripción ligeramente más larga'

# Configurando
setup(
       # el nombre debe coincidir con el nombre de la carpeta 	  
       #'modulomuysimple'
        name="modulomuysimple", 
        version=VERSION,
        author="Jason Dsouza",
        author_email="<tuemail@email.com>",
        description=DESCRIPTION,
        long_description=LONG_DESCRIPTION,
        packages=find_packages(),
        install_requires=[], # añade cualquier paquete adicional que debe ser
        #instalado junto con tu paquete. Ej: 'caer'
        
        keywords=['python', 'primer paquete'],
        classifiers= [
            "Development Status :: 3 - Alpha",
            "Intended Audience :: Education",
            "Programming Language :: Python :: 2",
            "Programming Language :: Python :: 3",
            "Operating System :: MacOS :: MacOS X",
            "Operating System :: Microsoft :: Windows",
        ]
)

Una vez hecho esto, ahora todo lo que tenemos que hacer es ejecutar el siguiente comando en el mismo directorio que base-modulomuysimple:

python setup.py sdist bdist_wheel

Esto va a construir todos los paquetes necesarios que requiera Python. Los comandos sdist y bdist_wheel van a crear una distribución fuente y una rueda que luego podrás cargar a PyPi.

PyPi — ¡aquí vamos!

PyPi es el repositorio oficial de Python donde se almacenan todos los paquetes de Python. Una forma de verlo es como el Github para paquetes de Python.

Para hacer disponible tu paquete de Python para personas en todo el mundo, tendrás que tener una cuenta con PyPi.

Con eso, estamos listos para cargar nuestro paquete a PyPi. ¿Recuerdas la distribución fuente y la rueda que se crearon cuando ejecutamos  python setup.py? Pues, esos serán los archivos que cargaremos a PyPi.

Pero antes de que lo hagas, necesitas instalar twine si no lo tienes instalado aún. Es tan simple como pip install twine.

Cómo cargar tu paquete a PyPi

Asumiendo que tienes twine instalado, ve y ejecuta:

twine upload dist/*

Este comando cargará los contenidos de la carpeta dist que se generó automáticamente cuando ejecutamos python setup.py. Recibirás un prompt solicitando tu usuario y contraseña de PyPi, así que ve a ingresarlos.

Ahora, si has seguido este tutorial al pie de la letra, podrías obtener un error que diga que el repositorio ya existe.

Esto usualmente ocurre porque hay una coincidencia de nombres entre el nombre de tu paquete y un paquete que ya existe. En otras palabras, cambia el nombre de tu paquete— alguien más ya ha tomado ese nombre.

¡Y eso es todo!

Para pip instalar orgullosamente tu módulo, enciende la terminal y ejecuta:

pip install <nombre_paquete> 

# en nuestro caso, esto es
pip install modulomuysimple

Observa cómo Python instala con orden tu paquete a partir de los binarios generados anteriormente.

Abre un intérprete interactivo de Python e intenta importar tu paquete:

>> import modulomuysimple as mms

>> mms.suma(2,5)
7
>> mms.resta(5,4)
1

Para acceder a los métodos de división y multiplicación (¿recuerdas que estaban en una carpeta llamada extras?), ejecuta:

>> import modulomuysimple as mms

>> mms.extras.divide(4,2)
2
>> mms.extras.multiplica(5,3)
15

Es así de simple.

¡Felicitaciones! Acabas de crear tu primer paquete de Python. Aunque sea muy simple, tu paquete ahora se encuentra disponible para ser descargado por cualquier persona en el mundo (siempre y cuando tengan Python, por supuesto).

¿Qué sigue?

Test PyPi

El paquete que usamos en este tutorial era un módulo extremadamente simple —operaciones matemáticas básicas de adición, sustracción, multiplicación y división. No tiene sentido cargarlos directamente a PyPi especialmente porque estás intentando esto por primera vez.

Por suerte, está Test PyPi, una instancia aparte de PyPi donde puedes probar y experimentar con tu paquete (tendrás que registrar una cuenta separada en la plataforma).

El proceso que sigues para cargar a Test PyPi is prácticamente el mismo con algunos pequeños cambios.

# El siguiente comando va a cargar el paquete a Test PyPi
# Se te solicitarán tus credenciales de Test PyPi 

twine upload --repository testpypi dist/*

Para descargar proyectos de Test PyPi:

pip install --index-url "https://test.pypi.org/simple/<nombre_paquete>"

Metainformación avanzada

La metainformación que usamos en el archivo setup.py era bastante básica. Puedes añadir información adicional tales como múltiples mantenedores (si los tiene), correo electrónico del autor/a, información de licencia y una multitud de datos adicionales.

Mira otros repositorios

Puede serte de mucha utilidad ver de qué manera otros repositorios han creado sus paquetes.

Cuando estaba creando Caer, constantemente veía cómo Numpy y Sonnet configuraban sus paquetes. Recomendaría que le eches un vistazo a los repositorios de Caer, Numpy y Tensorflow si planeas crear paquetes ligeramente más avanzados.