I've got an iPhone app with icon file Icon.png.
This icon shows up properly when the app is on the phone itself, but it doesn't show up in the applications pane in iTunes.
What do I need to do to get it to show up properly?
The cleanest way to do this is described in the official Apple documentation, in a section called Publishing Applications for Testing. Below is the exact instructions given to you on that page:
The iTunes artwork your testers see should be your application’s icon. This artwork must be a 512 x 512 JPEG or PNG file named iTunesArtwork. Note that the file must not have an extension.
After generating the file of your application’s icon, follow these steps to add it to your application:
Open your project in Xcode.
In the Groups & Files list, select the Resources group.
Choose Project > Add to Project, navigate to your iTunesArtwork file, and click Add.
In the dialog that appears, select the ”Copy items” option and click Add.
Note that the PNG or JPEG file is just 'iTunesArtwork', with no suffix.
If you try to copy the file into the application bundle after you have built it, it will break the app signing, and you will get a verification error when trying to sync it to your device. Ensure that the artwork file is included in the "Copy Bundle Resources" folder, within your project's target in XCode (step 4, above).
Create a 512x512 png of your icon, name it "iTunesArtwork" (no extension, no quotes) and add it to your project under Resources. Then build.
More details here:
http://developer.apple.com/library/ios/#documentation/Xcode/Conceptual/ios_development_workflow/000-Introduction/introduction.html
In order to make it easier for those arriving at this post, here are the actual instructions (straight from the blog post linked from the accepted answer).
There has been some talk on twitter about how to create your own IPA file for your iPhone app, so I thought I would give the instructions that I have used to build an IPA before. Enjoy.
Create a folder on your desktop called “working”. Open that and create another folder inside of it called “Payload” (case-sensitive)
Move your iTunesArtwork file into the “working” folder and your .app into the Payload folder.
Open Terminal and run the following command: chmod -R 775 ~/Desktop/working/Payload
Go into your ProgName.app folder within Payload.
Double-click the Info.plist file. Make sure there is a item called: SignerIdentity with a value of: Apple iPhone OS Application Signing. If there is not, add it.
Zip it all up. Zip the iTunesArtwork and Payload folder. (So zip up what is inside of the working folder)
Rename the zip file to have the name you want, and the extension of ipa.
Double click to install with iTunes
Actually, it is possible to provide iTUnes icons for iPhone software released as ad-hoc. See this blog post for more information.
I'll just add my recent experience. I had fooled around trying to get my ad hoc app to show up in iTunes with an icon (strictly, iTunesArtwork). Finally, I was convinced I had followed the instructions to a 'T' but it still wouldn't show up in the grid view. However, my artwork was properly displayed in the Cover Flow view. I deleted and reinstalled my app from/to iTunes to no avail. Then I quit iTunes and restarted - and, voila! - my artwork was correct in all places. It appears there is some kind of caching that is not reset in Grid view.
If you see a black square instead of you icon in iTunes, be sure that file type of iTunesArtwork in Xcode isn't "image.png". If so, in the copy resource build phase, CopyPNGFile will crash the file which invalid save for iOS divices.
Open your project in Xcode.
Copy iTunesArtwork.png file into project folder.
Edit iTuneArtwork.png file and remove .png from iTunesArtwork.
Generate build.
You can see image on iTunes.
The application icon only shows up in iTunes if your app is distributed through the app store.
I assume you are asking about a developer or ad hoc build. Those get the default black "A" icon.
Related
We have an updated version of our app icon to replace the existing one, we tried to simply overwrite the old one (image file) with the new version (image file), build and then deploy, what we found on the device is still the old icon being used for our app. Is this a normal behavior, what's the "official" steps for such needs? Note that we are still in development stage, which is why we need to update our app icons based on the new art work done by our designers.
Even i faced the same issue ,& its just because the app still has the reference to the old icon file or may be it has not been deleted from the resources, you may have opted for reference only while deleting the app icon.
It's simple ,
For easy followup I have attached the Screenshots too : ;)
1) Delete your application icon.png from the app, selecting an option "Also Move to Trash" .
2) Now Clean build & all the targets.
3) Reveal in finder the resource folder in your app & first copy your New App icon over there.
4) Now, drag & drop the new application icon from application finder to your Resource folder, make sure to check the option to copy items.
5) Also, prior to submitting the application to AppStore, make sure to do changes in your .plist file.Add value icon.png value to Icon file key.
Once, you are done with all the steps, just reset your Simulator & Run the app. I am sure that would solve your problem.
First of all delete the icon.png then select the image you want to create the icon select and drag it and put the following place and clean up your project(Cmd + shift + k).
Now the run the project and it change the icon of the application.
i think it's helpful for you
do cmd+k (to clean) then cmd+r (to run)
Clean build folder first before you redeploy, Xcode cache some of the data. To clean build folder, Go to Products, and hold option, there will be an option to.
Reference Apple Technical docs, about Troubleshooting section. That technical document gives details about this icon issue.
The following is what I encounter.
Error: Invalid Image Path
Your application's information property list references one or more icon images that were not included in the compiled bundle.
If your application is using asset catalogs to manage its icons then the information property list should not include any icon related keys; they will be added at build time by the asset catalog compiler.
Open the information property list for your app's target. It can be found under the Info tab in the project editor or in the File Navigator where it will be named either -Info.plist or Info.plist, where is the name of your app.
Remove the following keys, including device specific variations.
“Icon file” (CFBundleIconFile)
“Icon files” (CFBundleIconFiles)
CFBundleIcons
My project use App Icons Source to manage app icons, but the Info.plist also contains Icon files, and images in the resources.
More ...
If you encounter following case, reference that apple docs, it will help you.
The wrong icon appears in the App Store
Your application bundle includes additional images which are being detected as valid icon images.
I created an iPhone application. I am distributing it with the ad hoc method. It installs just fine from the iTunes installed on the machine where the app was created. Anywhere else the iTunes just gives the error 'Resources have been modified'.
Please help.
It's possible it is being changed. You should distribute your app as an .ipa file, this will shield it from changes.
Create a folder called Payload and place your .app folder inside of it. Zip up the Payload folder using normal compression, then rename the file with a .ipa extension.
In addition to tewha's answer:
One thing to note is that if you want the app's artwork to appear in iTunes (rather than a generic app icon), you need to place a file called iTunesArtwork (with no extension) into the zip file on the same level as the Payload folder (not in it). This is actually a jpeg file of a 512x512 image and this will appear in iTunes for the app. When I was converting folders, I didn't have the original images so I just left them off, the app works fine you just get the generic icon.
i am newbie to this forum. I have created my first iPhone application and created a distribution provision for executing in iPhone device.
While Sync my application to iPhone from iTunes, the icon of application is gud. After sometime the icon in iTunes gets changed into an square image. I have followed the following steps to create my iTunes artwork file.
Steps followed:
The iTunes artwork your testers see should be your application’s icon. This artwork must be a 512 x 512 JPEG or PNG file named iTunesArtwork. Note that the file must not have an extension.
After generating the file of your application’s icon, follow these steps to add it to your application:
Open your project in Xcode.
In the Groups & Files list, select the Resources group.
Choose Project > Add to Project, navigate to your iTunesArtwork file, and click Add.
In the dialog that appears, select the ”Copy items” option and click Add.
Note that the PNG or JPEG file is just 'iTunesArtwork', with no suffix.
Can anyone please suggest me how to make app icon in iTunes to be same as the one which is in my iPhone device ?
Thanks for any Help !
Sathiya
As per the suggestion of Chris Garrett, i have created the same png file for app icon in device and in iTunes. It looks fine when it is installed but when i restart the machine the the app icon in iTunes gets changed as square icon.
please suggest me to solve this !
The app icon on your devices is a 57x57 png file located in your project directory. The one you are uploading to iTunes Connect is a different 512x512 png file. You'll want to make sure these two icons are basically the same (other than scaling effects). It sounds like the icon in your project directory is different than the one you are uploading to iTunes.
Assuming that this is about Ad Hoc builds:
Make sure that there is no extension, you may need to Get Info and remove the ".jpg" extension there.
Also see msg 173247:
How can I make my ad hoc iPhone application's icon show up in iTunes?
I'm trying to add the iTunesArtwork file to my iPhone application in order to follow the guidelines for icons/artwork for iTunes. I've added a file that matches the iTunesArtwork requirements (512x512 JPG) to my project. Once I do that, I can no longer install the application on my device. I keep getting this error:
Your mobile device has encountered an unexpected error (0xE8000058)
iTunesArtworkCaptureFailed
Does anyone have any experience resolving this?
In the case of an ad hoc build, I've had some success doing the following:
Create a 512x512 png of the icon/artwork you want to show up in iTunes.
Rename the file to iTunesArtwork (with no extension and that capitalization) and
place it in your app root folder and
then add it at the top level of your application resources in xcode.
Rebuild the app in release for the device version you are deploying to
I've had this work with ad hoc builds, but to be honest I took it out because it works when I do provisioned release builds and causes the error you show there when I do debug builds and try to run on the simulator. It wasn't worth the hassle of adding and removing the file from the project for me.
I'm pretty sure that file needs to be a .png not .jpg?
Try removing the file, doing a clean, then re adding the file as iTunesArtwork
BTW you don't need that file - it's just so that Adhoc distribution has the icon show up in iTunes - it's not needed for App Store apps. They get the icon from a combo of the 57x57 icon and the 512 image you upload to iTunesConnect.
I've got an iPhone app with icon file Icon.png.
This icon shows up properly when the app is on the phone itself, but it doesn't show up in the applications pane in iTunes.
What do I need to do to get it to show up properly?
The cleanest way to do this is described in the official Apple documentation, in a section called Publishing Applications for Testing. Below is the exact instructions given to you on that page:
The iTunes artwork your testers see should be your application’s icon. This artwork must be a 512 x 512 JPEG or PNG file named iTunesArtwork. Note that the file must not have an extension.
After generating the file of your application’s icon, follow these steps to add it to your application:
Open your project in Xcode.
In the Groups & Files list, select the Resources group.
Choose Project > Add to Project, navigate to your iTunesArtwork file, and click Add.
In the dialog that appears, select the ”Copy items” option and click Add.
Note that the PNG or JPEG file is just 'iTunesArtwork', with no suffix.
If you try to copy the file into the application bundle after you have built it, it will break the app signing, and you will get a verification error when trying to sync it to your device. Ensure that the artwork file is included in the "Copy Bundle Resources" folder, within your project's target in XCode (step 4, above).
Create a 512x512 png of your icon, name it "iTunesArtwork" (no extension, no quotes) and add it to your project under Resources. Then build.
More details here:
http://developer.apple.com/library/ios/#documentation/Xcode/Conceptual/ios_development_workflow/000-Introduction/introduction.html
In order to make it easier for those arriving at this post, here are the actual instructions (straight from the blog post linked from the accepted answer).
There has been some talk on twitter about how to create your own IPA file for your iPhone app, so I thought I would give the instructions that I have used to build an IPA before. Enjoy.
Create a folder on your desktop called “working”. Open that and create another folder inside of it called “Payload” (case-sensitive)
Move your iTunesArtwork file into the “working” folder and your .app into the Payload folder.
Open Terminal and run the following command: chmod -R 775 ~/Desktop/working/Payload
Go into your ProgName.app folder within Payload.
Double-click the Info.plist file. Make sure there is a item called: SignerIdentity with a value of: Apple iPhone OS Application Signing. If there is not, add it.
Zip it all up. Zip the iTunesArtwork and Payload folder. (So zip up what is inside of the working folder)
Rename the zip file to have the name you want, and the extension of ipa.
Double click to install with iTunes
Actually, it is possible to provide iTUnes icons for iPhone software released as ad-hoc. See this blog post for more information.
I'll just add my recent experience. I had fooled around trying to get my ad hoc app to show up in iTunes with an icon (strictly, iTunesArtwork). Finally, I was convinced I had followed the instructions to a 'T' but it still wouldn't show up in the grid view. However, my artwork was properly displayed in the Cover Flow view. I deleted and reinstalled my app from/to iTunes to no avail. Then I quit iTunes and restarted - and, voila! - my artwork was correct in all places. It appears there is some kind of caching that is not reset in Grid view.
If you see a black square instead of you icon in iTunes, be sure that file type of iTunesArtwork in Xcode isn't "image.png". If so, in the copy resource build phase, CopyPNGFile will crash the file which invalid save for iOS divices.
Open your project in Xcode.
Copy iTunesArtwork.png file into project folder.
Edit iTuneArtwork.png file and remove .png from iTunesArtwork.
Generate build.
You can see image on iTunes.
The application icon only shows up in iTunes if your app is distributed through the app store.
I assume you are asking about a developer or ad hoc build. Those get the default black "A" icon.