# Desplegar el PKG de Shade en Jamf Pro

{% hint style="info" %}
Para consultar la documentación más reciente, consulte [la documentación PKG de Jamf Pro](https://learn.jamf.com/r/en-US/jamf-pro-documentation-current/Viewing_the_Contents_of_an_Indexed_Package)
{% endhint %}

#### Requisitos previos

* Acceso a Jamf Pro con permisos para cargar paquetes (normalmente **Administrador del servidor de Jamf Pro** o un rol que pueda gestionar Paquetes).
* Un Mac con un navegador que pueda descargar el instalador.
  * Si está descargando la app para macOS, Shade recomienda usar un navegador distinto de Safari.

#### 1) Descargue el PKG de Shade

1. Abra: <https://shade.inc/download>
2. En **Descargar Shade**, elija la compilación correcta para su Mac:
   * **macOS (Apple Silicon)** para Macs de la serie M (M1, M2, M3, M4)
   * **macOS (Intel)** para Macs Intel
3. Descargue el archivo del instalador.
4. Confirme que la descarga se completó y que tiene un único archivo de instalador para cargar (por ejemplo, en **Descargas**).

#### 2) (Recomendado) Valide el paquete antes de cargarlo

1. Verifique que descargó la arquitectura correcta (Apple Silicon frente a Intel).
2. Asegúrese de que el archivo:
   * Se abre o se instala correctamente en una máquina de prueba.
   * Tiene un tamaño de archivo razonable (no sospechosamente pequeño).
3. Cambie el nombre del archivo por uno claro y con versión (recomendado), por ejemplo:
   * `Shade-Desktop-<version>.pkg`

#### 3) Cargue el PKG en Jamf Pro

1. Inicie sesión en **Jamf Pro**.
2. Vaya a **Configuración**.
3. Navegue a la sección **Paquetes** (a veces aparece en **Gestión de equipos** según la versión de Jamf Pro que tenga).
4. Haga clic en **Nuevo** o **Cargar** (la etiqueta varía según la versión de Jamf Pro).
5. En el formulario de carga, seleccione el PKG de Shade que descargó.
6. Configure las **Ajustes del paquete** clave (opciones comunes):
   * **Nombre para mostrar**: Use un nombre claro (por ejemplo, `Shade`).
   * **Categoría**: Opcional, pero útil para la organización (por ejemplo, `Aplicaciones`).
   * **Prioridad**: Mantenga el valor predeterminado a menos que tenga varios paquetes dependientes.
   * **Requisitos del sistema operativo**: Establezca la versión mínima de macOS si su entorno lo requiere.
   * **Arquitectura**: Si Jamf permite especificarlo, coincida con el paquete que descargó (Apple Silicon frente a Intel).
7. Guardar.
8. Espere a que finalice la carga y luego confirme que el paquete aparece en la **Paquetes** lista.

#### 4) Confirme que el paquete está disponible para su implementación

1. Abra el paquete cargado en Jamf Pro.
2. Confirme:
   * El nombre y los detalles del paquete son correctos.
   * El paquete se muestra como cargado correctamente (sin errores).

#### 5) Siguientes pasos (opcional): implemente en los dispositivos

Después de cargar el PKG, puede implementarlo usando uno de estos enfoques:

* **Política**: Instale Shade bajo demanda (Self Service) o automáticamente (comprobación periódica, inscripción).
* **Inscripción PreStage**: Instale durante los flujos de trabajo de inscripción.

#### Implemente mediante Self Service (Bajo demanda)

Use este método si quiere que Shade esté disponible en la app Jamf Self Service, permitiendo que los usuarios elijan cuándo instalarlo.

1. **Cree una nueva política**: En Jamf Pro, vaya a **Equipos** > **Políticas** y haga clic en **Nuevo**.
2. **Carga útil general**:
   * **Nombre para mostrar**: `Instalar Shade`
   * **Disparador**: Ninguno (las políticas de Self Service no requieren un disparador del sistema).
   * **Frecuencia de ejecución**: `En curso` (esto permite a los usuarios reinstalar la app si se cambian a una nueva máquina o la eliminan accidentalmente).
3. **Carga útil de paquetes**:
   * Haga clic en **Configure** y busque su PKG de Shade cargado.
   * Asegúrese de que la acción esté configurada en **Instalar**.
4. **Carga útil de Self Service**:
   * Haga clic en la pestaña **Self Service** en la parte superior.
   * Marque la casilla **Hacer que la política esté disponible en Self Service**.
   * **Nombre para mostrar en Self Service**: `Shade`
   * **Nombre del botón**: `Instalar`
   * **Descripción**: Proporcione una breve descripción (por ejemplo, "Shade es su gestor de activos creativos...").
   * **Icono**: Cargue el icono de la aplicación Shade para darle un aspecto profesional.
5. **Ámbito**:
   * Haga clic en la pestaña **Ámbito** pestaña.
   * Añada los equipos específicos o Grupos inteligentes (por ejemplo, "Todos los clientes gestionados") que deberían ver Shade en su catálogo de Self Service.
6. **Guardar**.

***

#### Implemente mediante instalación silenciosa (automática)

Use este método si quiere que Shade se instale automáticamente en Macs en segundo plano sin ninguna interacción del usuario.

1. **Cree una nueva política**: En Jamf Pro, vaya a **Equipos** > **Políticas** y haga clic en **Nuevo**.
2. **Carga útil general**:
   * **Nombre para mostrar**: `Implementar Shade - Automático`
   * **Disparador**: Seleccione **Comprobación periódica** (este es el disparador estándar para implementaciones silenciosas en segundo plano).
   * **Frecuencia de ejecución**: Seleccione **Una vez por equipo**.
3. **Carga útil de paquetes**:
   * Haga clic en **Configure** y busque su PKG de Shade cargado.
   * Asegúrese de que la acción esté configurada en **Instalar**.
4. **Carga útil de mantenimiento**:
   * Haga clic en **Configure** y marque la casilla **Actualizar inventario** . Esto garantiza que Jamf sepa que la app está instalada inmediatamente después de que se ejecute la política.
5. **Ámbito**:
   * Haga clic en la pestaña **Ámbito** pestaña.
   * Añada los equipos o Grupos inteligentes que requieran Shade.
   * *Consejo: Use un Grupo inteligente que apunte a equipos donde "Shade.app" no esté instalado actualmente.*
6. **Guardar**.

***

#### Verificar la implementación

Después de guardar su política, puede supervisar su progreso:

* **Registros**: Abra la política en Jamf Pro y haga clic en el **Registros** botón en la esquina inferior derecha. Esto le mostrará qué equipos han instalado correctamente el paquete y cuáles siguen pendientes.
* **Inventario**: Verifique el registro de inventario de un equipo individual en **Aplicaciones** para confirmar `Shade.app` aparece en la lista.

#### Consejos de solución de problemas

* **Desajuste de arquitectura**: Si falla una instalación silenciosa, verifique que no haya implementado un PKG Intel en un Mac Apple Silicon (M1/M2/M3).
* **File Vault**: Si está implementando durante la inscripción (PreStage), asegúrese de que las opciones "Fill User Template" o "At Restart" NO estén seleccionadas, ya que Shade debe instalarse normalmente en la carpeta `/Applications` .folder
