Sumário
Mais Artigos da Jornada do Fundador
O CLI (Command Line Interface) do Shopify é uma das melhores ferramentas para criar aplicativos Shopify.
O Shopify CLI ajuda os parceiros Shopify a realizar várias tarefas importantes de criação de aplicativos. Isso inclui a geração de aplicativos Node.js, PHP e Ruby on Rails, bem como o desenvolvimento de extensões de aplicativos, temas e Scripts Shopify (atualmente em beta).
O Shopify CLI também automatiza várias dessas tarefas, o que encurta e simplifica significativamente o ciclo de criação de aplicativos.
Neste guia, abordaremos algumas das tarefas que você pode executar com o Shopify CLI e os benefícios dessa ferramenta específica para desenvolvedores de aplicativos.
O que é Shopify CLI para aplicativos?
CLI significa Command Line Interface. As ferramentas CLI são scripts, programas e bibliotecas que foram criados para um propósito de desenvolvimento específico.
O Shopify anunciou o lançamento da versão beta do Shopify CLI para aplicativos em novembro de 2019. Seu objetivo era ajudar os desenvolvedores a acelerar o processo de criação de aplicativos e aumentar a produtividade.
Como? Ao lançar uma ferramenta que pudesse ajudar de duas maneiras: criar um scaffold para código de aplicativo e automatizar parcialmente o desenvolvimento de aplicativos.
O Shopify CLI para aplicativos está atualmente na versão 1.1. Desde o lançamento da versão beta, houve grandes melhorias em sua robustez, e agora pode ser instalado facilmente em mais plataformas, incluindo Windows 10.
Quais são os benefícios de usar o Shopify CLI?
O Shopify CLI simplifica todo o processo de desenvolvimento de aplicativos. Ele remove algumas das principais barreiras que os desenvolvedores iniciantes enfrentam, tornando o desenvolvimento de aplicativos mais acessível para todos os tipos de usuários.
Também foi projetado para ser altamente flexível, portanto pode ser usado para uma variedade de diferentes tipos de aplicativos.
Esses princípios de flexibilidade, adaptabilidade e acessibilidade se manifestam em várias decisões de design importantes:
-
O CLI pode ser usado em Windows e Mac
-
Os desenvolvedores instalam o programa na linguagem que é mais confortável para eles
-
As ferramentas são de código aberto e não exigem aumento de privilégios
-
As operações não se autodestruem; os usuários estão em controle total da exclusão de arquivos e projetos
Vamos ver o Shopify CLI em ação!
Como usar o Shopify CLI
O Shopify CLI para aplicativos é uma ferramenta altamente intuitiva. O Shopify e o GitHub também fornecem tutoriais detalhados para cada etapa do caminho.
1. Instalação
O Shopify CLI pode ser instalado em vários sistemas operacionais diferentes. A maneira mais fácil de fazer isso é através da linha de comando do seu computador. Aqui está uma lista completa de requisitos de software.
2. Criando um projeto
Quando você vai criar um aplicativo no Shopify CLI, será solicitado que você insira algumas informações importantes sobre você, como sua organização, loja de desenvolvimento e o tipo de aplicativo que deseja criar (aqui, você tem a opção de criar um com backend Node.js e frontend React ou usar Ruby on Rails). O Shopify criará seu aplicativo no Painel de parceiros do Shopify.
Dê uma olhada neste modelo do site do Shopify:
Em seguida, o Shopify CLI executará um túnel para você com "shopify serve". Seu aplicativo agora está acessível à Internet através de uma porta "https", que é um requisito de autenticação para o Shopify. Isso fará o túnel de seu aplicativo usando ngrok, bem como executará seu servidor para desenvolvimento local.
3. População de aplicativos para testes
Então, como você sabe se está funcionando?
O Shopify CLI tem uma função de teste integrada: você pode preencher seu aplicativo exclusivamente para fins de teste. Se você executar o comando ''shopify populate'', poderá optar por preencher seu aplicativo com produtos, clientes e pedidos de rascunho.
4. Implantação
Como o nome sugere, o comando "shopify deploy" implanta seu aplicativo em plataformas externas. Atualmente, Heroku é a única plataforma externa disponível, mas mais estão em desenvolvimento (e quando você estiver lendo isso, talvez já estejam disponíveis!)
Como o Shopify construiu o Shopify CLI para aplicativos
O Shopify construiu muitas ferramentas para ajudar seus parceiros a criar aplicativos para a Shopify App Store. Essa é apenas uma razão pela qual argumentamos recentemente que desenvolver aplicativos para Shopify é melhor do que WooCommerce.
Algumas das ferramentas de linha de comando anteriores construídas pelo Shopify usam Node, Go e Ruby. O Shopify finalmente optou por Ruby pelos seguintes motivos:
- Ruby é mais acessível do que Go.
- Pode ser difícil gerenciar caminhos e instalações para uma ferramenta baseada em Node, mesmo que tenha algumas ótimas bibliotecas para escrever CLIs (yargs, ink, etc.)
- Go tornaria mais difícil para os parceiros do Shopify contribuirem com a ferramenta ao longo do tempo.
- As equipes de desenvolvimento do Shopify já estão familiarizadas com Ruby e construíram a estrutura CLI-kit e a coleção CLI-UI de padrões de interface de usuário de linha de comando usando Ruby.
Usando o Shopify CLI para temas
Os parceiros do Shopify agora podem usar o Shopify CLI para aplicativos para baixar, desenvolver, visualizar e testar alterações com segurança dentro de temas de desenvolvimento antes do lançamento. As alterações são preenchidas instantaneamente, para que você possa visualizar conforme avança. Quando o tema estiver pronto, ele pode ser enviado e publicado diretamente a partir da linha de comando.
Você também pode usar o CLI junto com a integração GitHub do Shopify para adicionar controle de versão a qualquer tema que esteja desenvolvendo. Se você quiser ver como isso funciona, este tutorial o guia através de todas as etapas do desenvolvimento de temas.
Que comandos estão disponíveis no Shopify CLI?
Vamos analisar algumas funções do Shopify CLI. Após criar um app Node.js, os seguintes comandos estão disponíveis:
- connect: Isso conectará ou reconectará um projeto existente a uma organização Shopify Partner e/ou loja. Ele criará ou atualizará o arquivo .env e criará o arquivo .shopify-cli.yml.
- Uso: shopify connect
- create: Isso criará um novo projeto.
- Uso: shopify create [ node | rails ]
- logout: Isso fará logout de uma organização Shopify Partner / loja autenticada no momento, ou limpará credenciais inválidas
- Uso: shopify logout
- version: Isso imprimirá o número da versão.
- Uso: shopify version
- deploy: Isso implantará o projeto Node atual em um serviço de hospedagem. Observe que Heroku é atualmente a única opção, mas Shopify planeja adicionar mais no futuro.
- Uso: shopify deploy [ heroku ]
- generate: Isso gerará código em seu projeto Node. Ele suporta a geração de novas chamadas de API de cobrança, novas páginas ou novos webhooks.
- Uso: shopify generate [ billing | page | webhook ]
- open: Isso abrirá seu app de desenvolvimento local no navegador padrão.
- Uso: shopify open
- populate: Isso preencherá sua loja de desenvolvimento Shopify com clientes, pedidos ou produtos de exemplo.
- Uso: shopify populate [ customers | draftorders | products ]
- serve: Isso iniciará um servidor de nó de desenvolvimento local para seu projeto e um túnel ngrok público para seu localhost.
- Uso: shopify serve
- tunnel: Isso iniciará ou interromperá um túnel http para seu app de desenvolvimento local usando ngrok.
- Uso: shopify tunnel [ auth | start | stop ]
Melhore seu desenvolvimento de app com Shopify CLI e Baremetrics
Shopify é a plataforma de comércio eletrônico líder hoje, graças aos seus 1,7 milhão de comerciantes leais, bem como aos 6.000 apps de terceiros atualmente à venda na Shopify App Store.
Shopify sempre se esforça para criar um processo melhor e mais simplificado para seus desenvolvedores. Valores compartilhados baseados em acessibilidade, comunicação aberta e inovação são a razão pela qual Baremetrics construiu nossa integração para apps Shopify.
Com nossa com Baremetrics, você pode acessar o melhor do que Baremetrics e Shopify têm a oferecer: melhor desenvolvimento de app e insights financeiros completos, tudo em um só lugar.
Perguntas Frequentes
-
O que é Shopify CLI e o que pode fazer pelos desenvolvedores de apps?
Shopify CLI é uma ferramenta de interface de linha de comando que ajuda desenvolvedores a criar estrutura, compilar e implantar apps Shopify mais rapidamente automatizando tarefas de configuração repetitivas.
Em vez de configurar tudo manualmente, o Shopify CLI permite que você gere uma estrutura de app funcional em minutos, escolhendo sua linguagem de backend preferida, como Node.js ou Ruby on Rails. Ele lida com tunneling via ngrok para que seu app local seja imediatamente acessível via HTTPS, que é necessário para a autenticação Shopify. Você também pode preencher uma loja de desenvolvimento com produtos de teste, clientes e pedidos de rascunho para validar seu app antes de entrar em operação. Ele é executado em Windows, Mac e Linux, e usa ferramentas de código aberto, portanto, nenhuma elevação de privilégios é necessária. -
Como configuro e uso Shopify CLI para começar a compilar um app Shopify?
Para usar o Shopify CLI para desenvolvimento de app, instale-o via linha de comando do seu computador, execute shopify create para criar a estrutura de um novo projeto, depois use shopify serve para iniciar um servidor de desenvolvimento local com um túnel ngrok ativo.
Durante a criação do projeto, você será solicitado pelos detalhes de sua organização Shopify Partner e sua pilha preferida. Node.js com um frontend React e Ruby on Rails são as duas opções suportadas. Depois que o servidor estiver em execução, seu app será acessível via uma porta HTTPS segura. A partir daí, você pode usar comandos como shopify populate para adicionar dados de teste, shopify generate para criar novas páginas ou webhooks, e shopify deploy para enviar seu app para Heroku quando estiver pronto para entrar em operação. -
Quais são os principais comandos Shopify CLI que todo desenvolvedor de app deve conhecer?
Os comandos Shopify CLI mais importantes são create, serve, populate, generate, deploy, connect e tunnel, cada um lidando com um estágio distinto do fluxo de trabalho de desenvolvimento de app.
Aqui está o que cada um faz:- shopify create: cria a estrutura de um novo app Node ou Rails e o registra em seu Painel de Parceiros
- shopify serve: inicia seu servidor local e abre um túnel ngrok para acesso HTTPS
- shopify populate: preenche sua loja dev com clientes de exemplo, produtos ou pedidos de rascunho para testes
- shopify generate: adiciona chamadas de API de cobrança, novas páginas ou webhooks a um projeto existente
- shopify deploy: envia seu app para Heroku para hospedagem externa
- shopify connect: vincula um projeto existente de volta a uma organização ou loja Partner
-
Por que Shopify escolheu Ruby para Shopify CLI em vez de Node ou Go?
Shopify compilou a CLI em Ruby porque é mais acessível que Go, evita a complexidade de caminho e instalação das ferramentas baseadas em Node, e se alinha com as estruturas internas que suas próprias equipes de engenharia já usam.
Go teria dificultado para os Shopify Partners contribuírem com o projeto de código aberto ao longo do tempo. Node possui bibliotecas CLI úteis como yargs e ink, mas gerenciar dependências e caminhos de ambiente cria atrito para desenvolvedores novatos na plataforma. Ruby permitiu que a Shopify reutilizasse seu framework CLI-kit existente e sua biblioteca de padrões CLI-UI, mantendo a ferramenta consistente com suas práticas de desenvolvimento internas, enquanto mantinha a barreira de entrada baixa para contribuidores externos. -
Como o Shopify CLI se compara à criação manual de aplicativos Shopify sem uma ferramenta CLI?
Usar o Shopify CLI para criar aplicativos é significativamente mais rápido do que a configuração manual, pois automatiza scaffolding, configuração de tunnel e criação de dados de teste em um único fluxo de trabalho.
Sem uma ferramenta de interface de linha de comando, os desenvolvedores devem configurar manualmente autenticação, configurar tunelamento HTTPS, registrar o aplicativo no Partner Dashboard e escrever código boilerplate do zero. O Shopify CLI faz tudo isso em alguns comandos. Também reduz o risco de erros de configuração que desaceleram os ciclos iniciais de desenvolvimento. Para fundadores de SaaS e equipes de desenvolvimento que desejam lançar um aplicativo Shopify rapidamente, o CLI reduz o estágio de configuração de horas para minutos e mantém o foco na construção da lógica do produto real em vez da infraestrutura. -
Como os fundadores de SaaS podem rastrear a receita de um aplicativo Shopify depois que ele entra em operação?
Depois que seu aplicativo Shopify estiver ativo e gerando receita de assinatura, você precisa de uma plataforma de análise dedicada para rastrear MRR, churn, LTV e conversão de teste para pago em tempo real.
O Shopify CLI ajuda você a criar e implantar o aplicativo, mas não oferece visibilidade sobre como esse aplicativo está funcionando como um negócio de assinatura. É aí que o Baremetrics entra. Ao conectar seu processador de pagamento, você obtém painéis em tempo real mostrando novo MRR, expansão de MRR, contração e receita perdida por churn de forma clara. Você também pode usar Baremetrics Recover para tentar automaticamente novamente os pagamentos com falha e reduzir o churn involuntário, que é um dos vazamentos de receita mais comuns para aplicativos de assinatura em estágio inicial. -
Como posso comparar as métricas de assinatura do meu aplicativo Shopify com outras empresas de SaaS?
Você pode comparar sua taxa de churn, crescimento de MRR e LTV com empresas de SaaS comparáveis usando o Baremetrics Open Benchmarks, que agrega dados anonimizados de centenas de negócios de assinatura.
Depois de implantar seu aplicativo Shopify e estar coletando receita de assinatura, saber se seus números são fortes ou estão atrasados em relação a produtos semelhantes é crítico para tomar decisões de preço e retenção. O Baremetrics mostra dados de benchmark para que você possa comparar sua taxa de churn, receita média por conta e taxa de conversão de teste com negócios em um estágio de MRR similar. Em vez de adivinhar se uma taxa de churn mensal de 5% é aceitável, você pode ver exatamente onde está em relação ao seu grupo de pares e priorizar as métricas que precisam de mais atenção.