Page 1 of 1

How to Install on iOS?

Posted: 22 Aug 2016, 23:10
by Forteissimo
Hello, first of all, I'd like to thank you for making this port possible! I deeply appreciate all the hard work that has gone through this project, and I'm simply eager the see what you've done with Chiru.
I apologize if I'm ignoring any previously shown instructions, but I am having trouble installing the game through iOS and I'd like to ask how exactly do I install it?

Re: How to Install on iOS?

Posted: 23 Aug 2016, 05:59
by vit9696
Hi, I moved your message to a new topic to make things easier to handle, after all the issue is not related to the sound problems.

As of iOS we are still thinking whether to write the FAQ entry or not, we are a bit lazy :D
It is a really simple task of 3 steps:
— Checking the requirements;
— Installing the ipa;
— Copying game files.
I will try to cover them all, so it is going to be a little lengthy :)

1. The lowest requirements are iOS 8 and iPad 4 and newer, but to get optimal performance and avoid crashes without disabling several optimisations you need a device with 2 or more gigabytes of memory (Air 2, mini 4, either Pro, and likely newer when they appear).
  • If you have an older model (4 or Air) you will need to disable Object caching in preferences otherwise you will get the crashes. They may still happen in intensive scenes, like credits, but we are working on reducing them to the minimum. At least I was able to play the game without many issues.
  • If you get battery drain you might want to add force-fps=30 to ons.cfg file after the first launch of the game.
  • If you need to get 1080p movie playback (although on iOS it is absolutely irrelevant and not visible and I recommend going with 720p) you will need hwdecoder=on in ons.cfg.
  • If you have iPad 4 you should armv7s binary, if you have any other model please go with arm64.
  • To reduce game weight you could safely delete video/1080p folder.
  • After installing the game make sure to open it at least once to avoid getting a 6 gigabyte backup in iCloud.
2. To be able to install the ipa file you should pick one route you prefer:
a) Jailbreak your tablet (e.g. http://en.pangu.io/help.html), then install AppSync Unified from http://cydia.angelxwind.net, the. just install an ipa file via any software (I personally use mobiledevice and iMazing, but there are many other tools that work just fine (iFunBox, iTools, etc.). The guide how to jailbreak is explained on pangu page, and there are many guides on the net on how to install AppSync Unified and later use it to get an app.
b) Not going with a jailbreak and using your Apple ID. http://en.pangu.io/help.html has a really nice guide on how to sign their application with Cydia Impactor and then install it on the device. Just follow it but use our ipa file and not any other. The only issue here is that you will have to resign the app every week.
c) Not going with a jailbreak and using Apple Developer provisioning. This is very similar with the previous variant but requires paid membership (99$) in Apple Developer program as well as a Mac. You enrol as a developer and create the signing certificates (or ask a friend or another developer to make them for you, this is likely going to be much cheaper), and then use codesign or gui tools like https://dantheman827.github.io/ios-app-signer/. I think you might be able to do it on Windows and Linux as well, just google for "resign ipa file" with an os postfix.

3. After installing the ipa file you simply open iTunes or any other program and copy the game files to the app (the section is called File sharing if I remember correctly). You do not need the dll files or the engines but everything else is necessary.

Feel free to ask any questions I do expect myself to be able to answer. There are quite a lot of (video)guides on the net regarding the 2nd step, so I feel you might prefer them over mine.

Re: How to Install on iOS?

Posted: 24 Aug 2016, 04:25
by Forteissimo
Thank you for taking the time to write this guide, I really appreciate it! I decided on using Cydia Impactor to install the .ipa file. However, I'm having a hard time getting it to install.
Whenever I try to do so, I keep getting this error.

I figured I had probably mistyped the Apple ID or missed a step, but after trying to install some other unrelated application, just to be sure I wasn't doing anything wrong, everything seemed to work just fine and the app was installed without any trouble. I imagine it must be something related to the Umineko .ipa, but I wouldn't know what is it.

Re: How to Install on iOS?

Posted: 24 Aug 2016, 05:10
by vit9696
You are correct, there is something related: Cydia Impactor does not tolerate the underscore symbol in our CFBundleName property x_X We will contact saurik, hopefully he fixes that and updates Cydia Impactor rather soon.

As for now you could simply remove/replace the symbol:
1. Download an ipa (e.g. onscripter-ru_arm64_r2290.ipa)
2. Rename it to a zip file (e.g. onscripter-ru_arm64_r2290.zip)
3. Extract it anywhere. You will see Payload folder and iTunesArtwork
4. Open Payload → onscripter-ru_arm64.app → Info.plist file in any text editor and replace:

Code: Select all

	<key>CFBundleName</key>
	<string>onscripter-ru_arm64</string>
with something not having the _ symbol, e.g.:

Code: Select all

	<key>CFBundleName</key>
	<string>onscripter-ru-arm64</string>
5. Save the file and update the zip archive (or recreate it, you should put Payload and iTunesArtwork to the root of it)

Once you rename the updated archive back to ipa you will be able to install the app with Cydia Impactor.
We are rather sorry for causing you trouble but in no way we expected such behaviour from a seemingly reliable tool.

P. S. Be aware that some operating systems hide known file extensions leaving only the name visible (i.e. cutting ipa, zip, etc.). Just google something like "unhide file extensions" if you need a hint how to get them back :)