Tutorial

Novas atualizações e melhorias para a Macfleet.

Aviso importante

Os exemplos de código e scripts fornecidos nestes tutoriais são apenas para fins educacionais. A Macfleet não é responsável por quaisquer problemas, danos ou vulnerabilidades de segurança que possam surgir do uso, modificação ou implementação destes exemplos. Sempre revise e teste o código em um ambiente seguro antes de usá-lo em sistemas de produção.

Configure Screenshot Settings on macOS

Learn how to customize screenshot behavior on Mac devices including file format, save location, and naming conventions. Essential for standardizing screenshot settings across enterprise Mac fleets.

Change Screenshot Format

Change the default screenshot format from PNG to other formats:

#!/bin/bash

# Get current user context
CURRENT_USER=$(stat -f "%Su" /dev/console)
CURRENT_USER_UID=$(id -u "$CURRENT_USER")

# Configuration
SCREENSHOT_FORMAT="JPG"  # Options: PNG, JPG, PDF, PSD, TIFF, GIF, BMP

echo "Setting screenshot format to: $SCREENSHOT_FORMAT"

# Apply screenshot format setting
launchctl asuser $CURRENT_USER_UID sudo -iu "$CURRENT_USER" \
    defaults write com.apple.screencapture type "$SCREENSHOT_FORMAT"

# Restart SystemUIServer to apply changes
launchctl asuser $CURRENT_USER_UID sudo -iu "$CURRENT_USER" \
    killall SystemUIServer

echo "✅ Screenshot format changed to $SCREENSHOT_FORMAT"

Change Screenshot Location

Change the default save location from Desktop to another folder:

#!/bin/bash

# Get current user context
CURRENT_USER=$(stat -f "%Su" /dev/console)
CURRENT_USER_UID=$(id -u "$CURRENT_USER")

# Configuration
SCREENSHOT_LOCATION="$HOME/Downloads"  # Change to desired location

echo "Setting screenshot location to: $SCREENSHOT_LOCATION"

# Ensure directory exists
launchctl asuser $CURRENT_USER_UID sudo -iu "$CURRENT_USER" \
    mkdir -p "$SCREENSHOT_LOCATION"

# Apply screenshot location setting
launchctl asuser $CURRENT_USER_UID sudo -iu "$CURRENT_USER" \
    defaults write com.apple.screencapture location "$SCREENSHOT_LOCATION"

# Restart SystemUIServer to apply changes
launchctl asuser $CURRENT_USER_UID sudo -iu "$CURRENT_USER" \
    killall SystemUIServer

echo "✅ Screenshot location changed to $SCREENSHOT_LOCATION"

Change Screenshot Naming

Customize screenshot filename prefix and date/time inclusion:

#!/bin/bash

# Get current user context
CURRENT_USER=$(stat -f "%Su" /dev/console)
CURRENT_USER_UID=$(id -u "$CURRENT_USER")

# Configuration
SCREENSHOT_PREFIX="MacFleet"  # Change prefix from "Screenshot"
INCLUDE_DATETIME="0"          # 0=exclude, 1=include date/time

echo "Setting screenshot prefix to: $SCREENSHOT_PREFIX"
echo "Include date/time: $INCLUDE_DATETIME"

# Apply screenshot naming settings
launchctl asuser $CURRENT_USER_UID sudo -iu "$CURRENT_USER" \
    defaults write com.apple.screencapture name "$SCREENSHOT_PREFIX"

launchctl asuser $CURRENT_USER_UID sudo -iu "$CURRENT_USER" \
    defaults write com.apple.screencapture include-date "$INCLUDE_DATETIME"

# Restart SystemUIServer to apply changes
launchctl asuser $CURRENT_USER_UID sudo -iu "$CURRENT_USER" \
    killall SystemUIServer

echo "✅ Screenshot naming updated"
if [[ "$INCLUDE_DATETIME" == "0" ]]; then
    echo "📝 New filename format: ${SCREENSHOT_PREFIX}.png"
else
    echo "📝 New filename format: ${SCREENSHOT_PREFIX} [date] at [time].png"
fi

Complete Screenshot Configuration

Comprehensive script to configure all screenshot settings at once:

#!/bin/bash

# Function to configure screenshot settings
configure_screenshot_settings() {
    local format="$1"
    local location="$2"
    local prefix="$3"
    local include_date="$4"
    
    # Get current user context
    local current_user=$(stat -f "%Su" /dev/console)
    local current_user_uid=$(id -u "$current_user")
    
    echo "=== MacFleet Screenshot Configuration ==="
    echo "👤 User: $current_user"
    echo "📸 Format: $format"
    echo "📁 Location: $location"
    echo "📝 Prefix: $prefix"
    echo "📅 Include date/time: $include_date"
    echo "========================================"
    
    # Create location directory if needed
    launchctl asuser $current_user_uid sudo -iu "$current_user" \
        mkdir -p "$location"
    
    # Apply all screenshot settings
    launchctl asuser $current_user_uid sudo -iu "$current_user" \
        defaults write com.apple.screencapture type "$format"
    
    launchctl asuser $current_user_uid sudo -iu "$current_user" \
        defaults write com.apple.screencapture location "$location"
    
    launchctl asuser $current_user_uid sudo -iu "$current_user" \
        defaults write com.apple.screencapture name "$prefix"
    
    launchctl asuser $current_user_uid sudo -iu "$current_user" \
        defaults write com.apple.screencapture include-date "$include_date"
    
    # Restart SystemUIServer to apply all changes
    launchctl asuser $current_user_uid sudo -iu "$current_user" \
        killall SystemUIServer
    
    echo "✅ All screenshot settings applied successfully"
    
    # Show example filename
    if [[ "$include_date" == "0" ]]; then
        echo "📝 Example filename: ${prefix}.${format,,}"
    else
        echo "📝 Example filename: ${prefix} $(date '+%Y-%m-%d') at $(date '+%H.%M.%S').${format,,}"
    fi
}

# Enterprise configuration
SCREENSHOT_FORMAT="PNG"
SCREENSHOT_LOCATION="/Users/$(stat -f "%Su" /dev/console)/Pictures/Screenshots"
SCREENSHOT_PREFIX="MacFleet-Screenshot"
INCLUDE_DATETIME="1"

# Apply configuration
configure_screenshot_settings "$SCREENSHOT_FORMAT" "$SCREENSHOT_LOCATION" "$SCREENSHOT_PREFIX" "$INCLUDE_DATETIME"

Reset to Default Settings

Restore screenshot settings to macOS defaults:

#!/bin/bash

# Get current user context
CURRENT_USER=$(stat -f "%Su" /dev/console)
CURRENT_USER_UID=$(id -u "$CURRENT_USER")

echo "🔄 Resetting screenshot settings to defaults..."

# Remove custom screenshot settings
launchctl asuser $CURRENT_USER_UID sudo -iu "$CURRENT_USER" \
    defaults delete com.apple.screencapture type 2>/dev/null || true

launchctl asuser $CURRENT_USER_UID sudo -iu "$CURRENT_USER" \
    defaults delete com.apple.screencapture location 2>/dev/null || true

launchctl asuser $CURRENT_USER_UID sudo -iu "$CURRENT_USER" \
    defaults delete com.apple.screencapture name 2>/dev/null || true

launchctl asuser $CURRENT_USER_UID sudo -iu "$CURRENT_USER" \
    defaults delete com.apple.screencapture include-date 2>/dev/null || true

# Restart SystemUIServer to apply changes
launchctl asuser $CURRENT_USER_UID sudo -iu "$CURRENT_USER" \
    killall SystemUIServer

echo "✅ Screenshot settings reset to defaults"
echo "📝 Default: PNG format, Desktop location, 'Screenshot' prefix with date/time"

Enterprise Deployment Script

Script for bulk deployment across multiple Mac devices:

#!/bin/bash

# Enterprise screenshot standardization
COMPANY_NAME="MacFleet"
SCREENSHOT_CONFIG=(
    "format:PNG"
    "location:/Users/CURRENT_USER/Documents/Screenshots"
    "prefix:${COMPANY_NAME}-Screen"
    "include-date:1"
)

# Function to apply enterprise screenshot policy
apply_enterprise_screenshot_policy() {
    local current_user=$(stat -f "%Su" /dev/console)
    local current_user_uid=$(id -u "$current_user")
    
    echo "🏢 Applying Enterprise Screenshot Policy"
    echo "========================================="
    echo "Device: $(hostname)"
    echo "User: $current_user"
    echo "Timestamp: $(date)"
    
    # Parse configuration
    local format location prefix include_date
    for config in "${SCREENSHOT_CONFIG[@]}"; do
        IFS=':' read -r key value <<< "$config"
        # Replace CURRENT_USER placeholder
        value="${value//CURRENT_USER/$current_user}"
        
        case "$key" in
            "format") format="$value" ;;
            "location") location="$value" ;;
            "prefix") prefix="$value" ;;
            "include-date") include_date="$value" ;;
        esac
    done
    
    echo "📸 Format: $format"
    echo "📁 Location: $location"
    echo "📝 Prefix: $prefix"
    echo "📅 Include date: $include_date"
    
    # Create screenshots directory
    launchctl asuser $current_user_uid sudo -iu "$current_user" \
        mkdir -p "$location"
    
    # Apply settings
    launchctl asuser $current_user_uid sudo -iu "$current_user" \
        defaults write com.apple.screencapture type "$format"
    
    launchctl asuser $current_user_uid sudo -iu "$current_user" \
        defaults write com.apple.screencapture location "$location"
    
    launchctl asuser $current_user_uid sudo -iu "$current_user" \
        defaults write com.apple.screencapture name "$prefix"
    
    launchctl asuser $current_user_uid sudo -iu "$current_user" \
        defaults write com.apple.screencapture include-date "$include_date"
    
    # Apply changes
    launchctl asuser $current_user_uid sudo -iu "$current_user" \
        killall SystemUIServer
    
    echo "✅ Enterprise screenshot policy applied"
    echo "📊 Configuration complete on $(hostname)"
}

# Execute enterprise policy
apply_enterprise_screenshot_policy

Usage with MacFleet

  1. Configure desired format, location, and naming in the script variables
  2. Deploy through MacFleet's remote script execution
  3. Verify settings by taking a test screenshot
  4. Monitor compliance across device fleet

Supported File Formats

FormatDescriptionUse Case
PNGLossless compressionDefault, best quality
JPGLossy compressionSmaller file sizes
PDFVector formatDocument screenshots
TIFFHigh qualityProfessional imaging
GIFAnimation supportSimple graphics
BMPUncompressedWindows compatibility
PSDPhotoshop formatDesign workflows

Common Location Options

LocationPathPurpose
Desktop~/DesktopDefault location
Downloads~/DownloadsEasy access
Documents~/DocumentsOrganization
Pictures~/Pictures/ScreenshotsPhoto library
Custom/path/to/folderCompany specific

Troubleshooting

Settings not applied: Ensure SystemUIServer is restarted after changes Permission denied: Verify user context with launchctl asuser Directory not found: Ensure target directory exists before setting location

Tutorial

Novas atualizações e melhorias para a Macfleet.

Configurando um Runner do GitHub Actions em um Mac Mini (Apple Silicon)

Runner do GitHub Actions

GitHub Actions é uma plataforma poderosa de CI/CD que permite automatizar seus fluxos de trabalho de desenvolvimento de software. Embora o GitHub ofereça runners hospedados, runners auto-hospedados fornecem maior controle e personalização para sua configuração de CI/CD. Este tutorial o guia através da configuração e conexão de um runner auto-hospedado em um Mac mini para executar pipelines do macOS.

Pré-requisitos

Antes de começar, certifique-se de ter:

  • Um Mac mini (registre-se no Macfleet)
  • Um repositório GitHub com direitos de administrador
  • Um gerenciador de pacotes instalado (preferencialmente Homebrew)
  • Git instalado em seu sistema

Passo 1: Criar uma Conta de Usuário Dedicada

Primeiro, crie uma conta de usuário dedicada para o runner do GitHub Actions:

# Criar a conta de usuário 'gh-runner'
sudo dscl . -create /Users/gh-runner
sudo dscl . -create /Users/gh-runner UserShell /bin/bash
sudo dscl . -create /Users/gh-runner RealName "GitHub runner"
sudo dscl . -create /Users/gh-runner UniqueID "1001"
sudo dscl . -create /Users/gh-runner PrimaryGroupID 20
sudo dscl . -create /Users/gh-runner NFSHomeDirectory /Users/gh-runner

# Definir a senha para o usuário
sudo dscl . -passwd /Users/gh-runner sua_senha

# Adicionar 'gh-runner' ao grupo 'admin'
sudo dscl . -append /Groups/admin GroupMembership gh-runner

Mude para a nova conta de usuário:

su gh-runner

Passo 2: Instalar Software Necessário

Instale Git e Rosetta 2 (se estiver usando Apple Silicon):

# Instalar Git se ainda não estiver instalado
brew install git

# Instalar Rosetta 2 para Macs Apple Silicon
softwareupdate --install-rosetta

Passo 3: Configurar o Runner do GitHub Actions

  1. Vá para seu repositório GitHub
  2. Navegue para Configurações > Actions > Runners

Runner do GitHub Actions

  1. Clique em "New self-hosted runner" (https://github.com/<username>/<repository>/settings/actions/runners/new)
  2. Selecione macOS como imagem do runner e ARM64 como arquitetura
  3. Siga os comandos fornecidos para baixar e configurar o runner

Runner do GitHub Actions

Crie um arquivo .env no diretório _work do runner:

# arquivo _work/.env
ImageOS=macos15
XCODE_15_DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer
  1. Execute o script run.sh em seu diretório do runner para completar a configuração.
  2. Verifique se o runner está ativo e ouvindo por trabalhos no terminal e verifique as configurações do repositório GitHub para a associação do runner e status Idle.

Runner do GitHub Actions

Passo 4: Configurar Sudoers (Opcional)

Se suas ações requerem privilégios de root, configure o arquivo sudoers:

sudo visudo

Adicione a seguinte linha:

gh-runner ALL=(ALL) NOPASSWD: ALL

Passo 5: Usar o Runner em Fluxos de Trabalho

Configure seu fluxo de trabalho do GitHub Actions para usar o runner auto-hospedado:

name: Fluxo de trabalho de exemplo

on:
  workflow_dispatch:

jobs:
  build:
    runs-on: [self-hosted, macOS, ARM64]
    steps:
      - name: Instalar NodeJS
        run: brew install node

O runner está autenticado em seu repositório e rotulado com self-hosted, macOS, e ARM64. Use-o em seus fluxos de trabalho especificando estes rótulos no campo runs-on:

runs-on: [self-hosted, macOS, ARM64]

Melhores Práticas

  • Mantenha seu software do runner atualizado
  • Monitore regularmente os logs do runner para problemas
  • Use rótulos específicos para diferentes tipos de runners
  • Implemente medidas de segurança adequadas
  • Considere usar múltiplos runners para balanceamento de carga

Solução de Problemas

Problemas comuns e soluções:

  1. Runner não conectando:

    • Verifique conectividade de rede
    • Verifique validade do token GitHub
    • Certifique-se de permissões adequadas
  2. Falhas de build:

    • Verifique instalação do Xcode
    • Verifique dependências necessárias
    • Revise logs do fluxo de trabalho
  3. Problemas de permissão:

    • Verifique permissões do usuário
    • Verifique configuração sudoers
    • Revise permissões do sistema de arquivos

Conclusão

Agora você tem um runner auto-hospedado do GitHub Actions configurado em seu Mac mini. Esta configuração fornece mais controle sobre seu ambiente CI/CD e permite executar fluxos de trabalho específicos do macOS de forma eficiente.

Lembre-se de manter regularmente seu runner e mantê-lo atualizado com os patches de segurança e versões de software mais recentes.

Aplicativo Nativo

Aplicativo nativo do Macfleet

Guia de Instalação do Macfleet

Macfleet é uma solução poderosa de gerenciamento de frota projetada especificamente para ambientes Mac Mini hospedados na nuvem. Como provedor de hospedagem na nuvem Mac Mini, você pode usar o Macfleet para monitorar, gerenciar e otimizar toda sua frota de instâncias Mac virtualizadas.

Este guia de instalação o conduzirá através da configuração do monitoramento do Macfleet em sistemas macOS, Windows e Linux para garantir supervisão abrangente de sua infraestrutura na nuvem.

🍎 macOS

  • Baixe o arquivo .dmg para Mac aqui
  • Clique duas vezes no arquivo .dmg baixado
  • Arraste o aplicativo Macfleet para a pasta Aplicativos
  • Ejete o arquivo .dmg
  • Abra Preferências do Sistema > Segurança e Privacidade
    • Aba Privacidade > Acessibilidade
    • Marque Macfleet para permitir monitoramento
  • Inicie o Macfleet a partir de Aplicativos
  • O rastreamento inicia automaticamente

🪟 Windows

  • Baixe o arquivo .exe para Windows aqui
  • Clique com o botão direito no arquivo .exe > "Executar como administrador"
  • Siga o assistente de instalação
  • Aceite os termos e condições
  • Permita no Windows Defender se solicitado
  • Conceda permissões de monitoramento de aplicativo
  • Inicie o Macfleet a partir do Menu Iniciar
  • O aplicativo começa o rastreamento automaticamente

🐧 Linux

  • Baixe o pacote .deb (Ubuntu/Debian) ou .rpm (CentOS/RHEL) aqui
  • Instale usando seu gerenciador de pacotes
    • Ubuntu/Debian: sudo dpkg -i Macfleet-linux.deb
    • CentOS/RHEL: sudo rpm -ivh Macfleet-linux.rpm
  • Permita permissões de acesso X11 se solicitado
  • Adicione o usuário aos grupos apropriados se necessário
  • Inicie o Macfleet a partir do menu Aplicativos
  • O aplicativo começa o rastreamento automaticamente

Nota: Após a instalação em todos os sistemas, faça login com suas credenciais do Macfleet para sincronizar dados com seu painel de controle.