Skip to content

Latest commit

 

History

History

Xcode

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
Script
Script
 
 
doc/image
doc/image
 
 
Gemfile
Gemfile
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
appicon_mark.rb
appicon_mark.rb
 
 
icon_1024.png
icon_1024.png
 
 
install
install
 
 
proj_config.rb
proj_config.rb
 
 

README.md

Xcode Script Tools

AppInfo Icon Maker

Shell Script tool of Xcode.

Make App Dev-Info more clearer and straight. Info:

  • Git-Info (e.g. ver-hash,branch)
  • Xcode Project-Info (e.g. short-version,build-number)

Add text of above info to the App-Icon image as a watermark.

Featrue

  • Add infomation(git,project..) to App-Icon image.
  • Make a new 'AppIcon-Dev.appiconset' directory. You can select.

Requirement

test passed

Dependent On

Install

If you do not have brew installed, follow these steps to install

Homebrew

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

ImageMagick

brew install imagemagick

INSTALL (Automatic)

Copy install script file to your project folder as same as .xcodeproj directory, and run script:

./install

If nothing goes wrong, you are ready to go. try command + B build project in Xcode.

NOTE:Markup app icon only when CONFIGURATION=Debug

install command options:

install [PATH_TO_PROJECT_DIR] ['clean'/'noclean']

  • To unconfigure your project.
./install . noclean
./appicon_mark.rb uninstall --project <PATH_TO_YOUR_PROJECT>/<PROJECT_NAME>.xcodeproj
  • To remove all cache files.
./install . clean

INSTALL (Manual)

You can ignore the following steps, if already do step INSTALL (Automatic) above.

1. Import to project

Add tool to your project

1.1:

Add 2 files to the project(with copy).

  • icon_mark
  • lib/dev_kit.sh

BE-SURE: icon_mark, lib directory, in the same level.

1.2:

Xcode Project -> Target -> Build Phases -> Add 'Run Script' -> Edit to run script file

Edit Run Script content:

"<Path-To-Script>/icon_mark"

In this demo project use : "${PROJECT_DIR}/${PROJECT_NAME}/Script/icon_mark

1.3:

If Build Phases -> Copy Bundle Resources has the script files(icon_mark,lib/dev_kit.sh), and remove them.

2. Run And Setup (Manual Only)

  1. First Build your project; if success, AppIcon-Dev was generated in the .xcassets folder.
  2. Set project -> target -> General -> App Icons and Launch Images -> App Icons Source to AppIcon-Dev
  3. Run again. the AppIcon will be setup.

!Important

  • Make sure your project has the .appiconset folder which has a size:1024x1024 of App icon image in it.
  • The marked app icon only created in Debug CONFIGURATION.
  • Only support One .xcassets Directory (Random selected) of the project.

Reference

Related tools

LICENSE

MIT