iOS installation using Cydia impactor - Faifly/xDrip GitHub Wiki
iOS installation using Cydia impactor
This is the easiest method to install the iOS version of xDrip.
Table of contents:
- General information.
- Requirements.
- Common steps.
- Windows steps.
- Linux steps.
- macOS steps.
- Cydia Impactor common steps.
General information
- To install any iOS application on a non-jailbroken iPhone or iPad, you would need your own development account.
- There are two types of accounts - paid and free. Certificates for free accounts last for only 7 days, while for paid account lasts for 1 year, but this accounts costs $100 per year.
- To avoid xDrip from stopping working, make sure to renew the certificate before it expires.
- Always use the same Apple developer account, otherwise you won't be able to update the application.
- Read this guide till the end, because it contains important information.
Requirements
- Any macOS device, Windows PC or Linux machine.
- xDrip iOS
.ipa
file. You can download the latest version from the release page. - Cydia impactor:
Common steps
Apple ID
Regardless of whether you will use the free approach or the paid approach, you will need an Apple ID. If you don't have it yet, please go here and create an account.
Free approach
You need to go here and sign in into your Apple account.
If you are visiting this site for first time Apple asks you to submit their Developer Agreement.
And that's all for free account. Now you can install Xcode and build xDrip app on your device. If you want to have more features from xDrip app you can go to paid approach section and complete those steps.
Paid approach
You need to complete all steps from free approach section to go further.
If you want to experience all xDrip features you need to have paid Apple Developer account.
On this page you can find button that invite you to join Apple Developer Program.
By pressing this button you will be redirected to this page.
You can learn here about all benefits you have if you join the program.
To start your enrollment you need to press Enroll
button at the top right corner.
Then you will be redirected here.
To start enrollment you need to scroll to the bottom and press Start Your Enrollment
button.
Then you need to fill in few field to confirm your personal information.
Then Apple asks you to select your entity type.
Then you need to submit Apple Developer Program License Agreement.
Then Apple propose you to complete your purchase.
By clicking Purchase
you will be redirected here.
On this page you need to fill in your payment information. After that you will get Apple Developer Program Membership.
And that's all for paid account. Now you can install Xcode and build xDrip app on your device.
Next steps
After you finished setting up your development account, you can proceed to platform-specific steps below.
Windows steps
(Windows 7 has been used for this guide. All steps should be very similar when using other Windows versions)
Go to the folder where you’ve downloaded Impactor. We’ll use the Downloads folder for this guide
You’ll find a zip file with a name beginning with “Impactor”. Right-click on it and select Extract All.
A small popup will now appear. Press the Extract button.
Windows should automatically open the extracted Cydia Impactor’s folder but if not just double click the newly created folder next to the Cydia Impactor’s zip file you downloaded earlier. Once you’re inside the extracted Cydia Impactor’s folder, double click the application’s file to open it, the one with the wrench icon.
In most cases, Windows will notify you that the publisher has not yet been verified. Just press the Run button.
Now that Cydia Impactor is installed & running, you can proceed to сommon steps.
Linux steps
(Ubuntu 18.04 has been used for this guide)
Go to the folder where you’ve downloaded Impactor. We’ll use the Downloads folder for this guide.
You’ll find a tgz file with a name beginning with “Impactor”. Right click on it and select Extract Here.
A new folder will be created next to the Cydia Impactor tgz file you just extracted. Open the folder.
Inside you’ll find the Cydia Impactor’s executable file. Double click to open it.
Now that Cydia Impactor is installed & running, you can proceed to сommon steps.
macOS steps
After downloading all the requirements, go to your downloads folder and find Cydia impactor
installation image:
Double click to open it. A pop-up will appear. Drag and drop Impactor
into the Application
folder. This will install Cydia impactor
into your Applications
folder.
You might see a couple of prompts, just accept them and Cydia impactor
will open.
Cydia Impactor common steps
Connect your device via a USB cable. In a couple of seconds it should be displayed in Cydia impactor
:
Don't click Start
button right away. At first, you need to drag & drop xDrip.ipa
onto Impactor
:
The application will ask you your Apple ID account and password.
If you have enabled two-factor authentication for your account, you need to go to Apple ID management page and create an application specific password. To do that, click Generate password...
button:
You will see a pop-up where you should input the name of your application:
Just type Impactor
and click Create
:
You will see another pop-up with the password:
Don't forget to copy it and save it somewhere, because you won't be able to see it again.
If you have done everything correctly, the application will be installed on your iOS device and you should now be able to use xDrip!