Come posso rinominare completamente un progetto Xcode (comprensivo di cartelle)?

Condividi questo articolo:


Problema:

Ho un progetto in xCode chiamato XXX. Voglio rinominare questo progetto in YYY.

Notate che XXX è un termine estremamente comune (per esempio “dati”, o semplicemente “progetto”), e quindi una semplice ricerca e sostituzione RegEx non è possibile, per il rischio di corrompere i file di configurazione del progetto.

La mia attuale directory di progetto xCode contiene i seguenti elementi:

XXX
XXXTests
XXX.xcodeproj
e voglio rinominarli in:

YYY
YYYTests
YYY.xcodeproj
… rispettivamente, con le modifiche necessarie che si riflettono nel mio file di progetto.

Come posso realizzare questo senza dover creare e popolare manualmente un nuovo progetto?

 

Soluzione:

Passo 1 – Rinominare il progetto xCode

  • Clicca sul progetto che vuoi rinominare nel “Project navigator” nel pannello sinistro della finestra di Xcode.
  • Nel pannello di destra, seleziona “File inspector”, e il nome del tuo progetto dovrebbe essere trovato sotto “Identity and Type”. Cambialo con il tuo nuovo nome.
  • Quando la finestra di dialogo chiede se rinominare o non rinominare gli elementi del contenuto del progetto, clicca su “Rename”. Dì di sì a qualsiasi avvertimento sulle modifiche.

Passo 2 – Rinomina lo schema

  • In alto al centro della finestra, a sinistra del dispositivo/simulatore attivo, c’è uno schema per il tuo prodotto con il suo vecchio nome; clicca e tieni premuto su di esso, poi scegli “Manage Schemes…”.
  • Clicca sul vecchio nome nello schema (simile a rinominare i file in Xcode) e diventerà modificabile; cambia il nome e clicca “Close”.
LEGGI ANCHE:  La guida "non tecnica" per aumentare la velocità del vostro sito web

Passo 3 – Rinomina la cartella con le tue risorse

  • Esci da Xcode. Rinomina la cartella principale che contiene tutti i file del tuo progetto.
  • Nella cartella principale dal nome corretto, accanto al tuo nuovo file .xcodeproj, c’è probabilmente una cartella OLD dal nome sbagliato che contiene i tuoi file sorgente. Rinomina la cartella OLD con il tuo nuovo nome (se usi Git, potresti eseguire git mv oldname newname in modo che Git riconosca che questo è uno spostamento, piuttosto che cancellare/aggiungere nuovi file).
  • Riapri il progetto in Xcode. Se vedi un avvertimento “La cartella OLD non esiste”, elimina l’avvertimento. I file sorgente nella cartella rinominata avranno nomi rossi perché il percorso verso di loro si è interrotto.
  • Nel “Project navigator” nel pannello di sinistra, clicca sulla cartella di primo livello che rappresenta la cartella OLD che hai rinominato.
  • Nel pannello di destra, sotto “Identità e tipo”, cambia il campo “Nome” dal nome VECCHIO al nuovo nome.
  • Proprio sotto quel campo c’è un menu “Posizione”. Se il percorso completo non si è corretto, clicca sull’icona della cartella vicina e scegli la cartella rinominata. Potresti dover eseguire questa correzione per ogni file sorgente se i collegamenti ad essi rimangono interrotti.

Passo 4 – Rinominare i dati Build plist

  • Clicca sul progetto nel “Project navigator” sulla sinistra, e nel pannello principale seleziona “Build Settings”.
  • Cerca “plist” nelle impostazioni.
  • Nella sezione Packaging, vedrai i campi per Info.plist e Product Bundle Identifier.
  • Se c’è un nome di file inserito in Info.plist, aggiornalo (potrebbe essere stato aggiornato automaticamente nel passo 1).
  • Fai lo stesso per Product Bundle Identifier, a meno che non stia utilizzando la variabile ${PRODUCT_NAME}. In questo caso, cerca “product” nelle impostazioni e aggiorna Product Name. Se Product Name è basato su ${TARGET_NAME}, clicca sull’elemento di destinazione attuale nell’elenco TARGETS a sinistra del pannello delle impostazioni e modificalo, e tutte le impostazioni relative si aggiorneranno immediatamente.
  • Cerca nelle impostazioni “prefix” e assicurati che anche il percorso di Prefix Header sia aggiornato al nuovo nome.
  • Se usi SwiftUI, cerca “Development Assets” e aggiorna il percorso. Racchiudi in virgolette doppie (“”) se il percorso contiene uno spazio ( ).
LEGGI ANCHE:  Come risolvere in xCode 'NSUnknownKeyException', reason: … this class is not key value coding-compliant for the key X" error?

Passo 5 – Ripeti il passo 3 per i test (se li hai)
Passo 6 – Ripeti il passo 3 per i dati principali se il loro nome corrisponde al nome del progetto (se li hai)
Passo 7 – Pulisci e ricostruisci il tuo progetto

  1. Command + Shift + K per clean
  2. Command + B per build

Quando si usano i CocoaPods

Dopo il passo 2:

Esci da Xcode.
Nella cartella principale, rinomina OLD.xcworkspace in NEW.xcworkspace.

Dopo il passo 4:

  • In Xcode: scegli e modifica Podfile dal navigatore del progetto. Dovresti vedere una clausola di destinazione con il nome OLD. Cambialo in NEW.
  • Esci da Xcode.
  • Nella cartella del progetto, cancella il file OLD.podspec.
  • Esegui
  • Apri Xcode.
  • Clicca sul nome del tuo progetto nel navigatore del progetto.
  • Nel pannello principale, passa alla scheda Build Phases.
  • Sotto Link Binary With Libraries, cerca libPods-OLD.a e cancellalo.
  • Se hai un’intestazione objective-c Bridging vai su Build settings e cambia la posizione dell’intestazione da OLD/OLD-Bridging-Header.h a NEW/NEW-Bridging-Header.h
  • Pulisci ed esegui.

Andrea Piani Administrator
Mi chiamo Andrea Piani, sono un programmatore specializzato nello sviluppo di App iOS e Android. Appassionato di elettronica e blockchain. Divulgatore tecnologico. Creatore della web agency Immaginet Srl (Udine) e di PrestaExpert Srl (Milano), aziende specializzate in Digital Marketing ed e-commerce.
follow me

Vuoi una consulenza a pagamento? Vuoi sviluppare un software per la tua attività? Hai bisogno di informazioni? Compila il modulo per contattarmi. Ti risponderò entro 24 ore.

Fill out my online form.

Iscriviti alla newsletter. Scegli la categoria che preferisci. Solo articoli esclusivi e di alta qualità che non trovi sul blog. Niente SPAM. Promesso!


Condividi questo articolo: