Σελίδα ρύθμισης του AAPS Builder
Δημιουργήστε τη δική σας εφαρμογή AAPS στο GitHub. Χωρίς εγκατάσταση προγραμμάτων, χωρίς τερματικό. Την πρώτη φορά χρειάζεται περίπου 10 λεπτά. Μετά ξεκινάτε κάθε build μόνοι σας.
Κάθε βήμα εξηγείται πιο αναλυτικά, με στιγμιότυπα οθόνης, στη σελίδα Δημιουργία μέσω browser με το AAPS Builder. Κρατήστε αυτή τη σελίδα ανοιχτή σε άλλη καρτέλα.
Τα παρακάτω κουμπιά ανοίγουν το GitHub σε νέα καρτέλα του Chrome. Για να επιστρέψετε σε αυτή τη σελίδα, πατήστε το κουμπί καρτελών δίπλα στη γραμμή διευθύνσεων του Chrome (το τετράγωνο με έναν αριθμό) και επιλέξτε αυτή τη σελίδα.
Βήμα 1 – Δημιουργήστε το ιδιωτικό αποθετήριο build
This creates your own private copy of AAPS Builder in your GitHub account: a repository with the build workflow already in it. Μόνο εσείς μπορείτε να δείτε το αποθετήριο και τις εφαρμογές που δημιουργεί. Δεν χρειάζεται να κάνετε fork το AndroidAPS: ο πηγαίος κώδικας του AAPS κατεβαίνει από το επίσημο αποθετήριο AndroidAPS σε κάθε build.
Συνδεθείτε πρώτα στο github.com σε αυτόν τον browser (δεν έχετε λογαριασμό; δημιουργήστε έναν δωρεάν). Μετά επιστρέψτε εδώ. Γράψτε το όνομα χρήστη σας (φαίνεται στο προφίλ σας στο GitHub), όχι το email σας: η σελίδα ρωτά το GitHub αν υπάρχει αυτό το όνομα χρήστη.
Κρατήστε το προτεινόμενο όνομα. Έχετε ήδη δημιουργήσει το αποθετήριό σας με άλλο όνομα; Γράψτε εδώ ακριβώς αυτό το όνομα.
Σημείωση
Already have an AAPS Builder repository (made with an earlier version of this page)? Do not create a new one: type its exact name here, skip the button below, and update its workflow once: see Updating your copy at the end of this step. Your secrets stay as they are.
If you want a new repository anyway, choose a name you don’t have yet, for example my-aaps-2, and use the same keystore in step 2.
Do not type the name of your fork of AndroidAPS: a fork is public, and it already builds with its own AAPS CI workflow.
Your repository:
Check this name before you use the buttons below: the page remembers the name from your last visit.
On the GitHub page that opens, everything is already filled in: the template nightscout/aaps-builder, your account as owner, the name of your repository, and Private. Do not change anything, and leave Include all branches unticked.
Πατήστε το πράσινο κουμπί Create repository.
GitHub shows your new repository with a folder
.githuband a fileREADME.md: the build workflow is in it. Επιστρέψτε σε αυτή τη σελίδα για το βήμα 2.
Your new repository is empty (no files)?
It was not created from the template. Delete it (Settings → bottom of the page → Delete this repository), then tap Create my private repository again.
GitHub says «my-aaps already exists in this account»?
You already have your repository: close the GitHub tab and go on with this page. If your key is already in it, continue with step 4. See troubleshooting.
Updating your copy (existing AAPS Builder repository)
The build steps are updated for you: at every build, your repository runs the version released by the AAPS developers in nightscout/aaps-builder, and nothing in your repository changes. You only replace your workflow file when Docs updates & changes announces it (for example for a new build variant), or once if your repository was made with an earlier version of this page or from the old template. Your KEYSTORE_SET secret stays as it is.
-
On a computer, click the copy icon («Copy raw file») at the top right of the file. On a phone, open the plain-text version instead, press and hold the text → Select all → Copy.
-
Opens
.github/workflows/build.ymlin. Tap the ⋯ menu at the top right of the file, then Edit file… In place (on a computer, click the pencil). Replace the whole text with the copied workflow (on a phone: press and hold → Select all → Paste), then click Commit changes… twice. The first line of the file shows its version.
Step 2 – Your signing key
Η εφαρμογή πρέπει να υπογραφεί με το δικό σας κλειδί. Χρησιμοποιείτε πάντα το ίδιο κλειδί. Αλλιώς, για να ενημερώσετε, πρέπει να απεγκαταστήσετε το AAPS (και να χάσετε τις ρυθμίσεις του). Επιλέξτε μία από τις δύο καρτέλες.
Για παράδειγμα από το Android Studio (.jks).
Δημιουργείτε το AAPS για πρώτη φορά; Ένα νέο κλειδί δημιουργείται εδώ, στον browser σας. Δεν στέλνεται τίποτα πουθενά.
Αποθηκεύστε ένα αντίγραφο ασφαλείας του κλειδιού σας!
Κατεβάστε το αρχείο. Κρατήστε αυτά τα τρία μαζί, σε ασφαλές μέρος εκτός του τηλεφώνου σας (π.χ. στον δικό σας χώρο αποθήκευσης στο cloud):
το αρχείο
aaps-keystore.jksτον κωδικό σας
το alias του κλειδιού:
key0
Θα χρειαστείτε και τα τρία, αν ποτέ δημιουργήσετε το AAPS με άλλον τρόπο, π.χ. με το Android Studio.
Step 3 – Give the key to your repository
Finish step 2 first.
Βλέπετε "Page not found" (404); Ελέγξτε πρώτα ότι είστε συνδεδεμένοι στο github.com σε αυτόν τον browser: το GitHub δείχνει 404 για ιδιωτικά αποθετήρια όταν δεν είστε συνδεδεμένοι. Αλλιώς, το όνομα χρήστη ή το όνομα αποθετηρίου στο βήμα 1 δεν ταιριάζει με το αποθετήριό σας: ελέγξτε τα στο github.com και γράψτε τα στο βήμα 1. 2. Πατήστε "Copy name" και μετά επικολλήστε το στο μικρό πεδίο "Name": `KEYSTORE_SET` 3. Πατήστε "Copy secret" και μετά επικολλήστε τον μακρύ κώδικα στο μεγάλο πλαίσιο "Secret": Το secret είναι ένας πολύ μακρύς κώδικας (χιλιάδες χαρακτήρες), ΟΧΙ η λέξη KEYSTORE_SET. Αντιγράψτε και επικολλήστε πρώτα το όνομα και μετά τον μακρύ κώδικα. 4. Πατήστε "Add secret". Έτοιμο. Δεν χρειάζεται να το κάνετε ποτέ ξανά.
-
Ανοίγει:
Βλέπετε «Page not found» (404); Ελέγξτε πρώτα ότι είστε συνδεδεμένοι στο github.com σε αυτόν τον browser: το GitHub δείχνει 404 για ιδιωτικά αποθετήρια όταν δεν είστε συνδεδεμένοι. Αλλιώς, το όνομα χρήστη ή το όνομα αποθετηρίου στο βήμα 1 δεν ταιριάζει με το αποθετήριό σας: ελέγξτε τα στο github.com και γράψτε τα στο βήμα 1. Άνοιξε αντί γι” αυτό η εφαρμογή GitHub; Πατήστε «RUN WORKFLOW», ελέγξτε την έκδοση και την παραλλαγή (variant) και πατήστε ξανά «RUN WORKFLOW». Αν η εφαρμογή δείχνει ακόμα «Nothing to see here», τραβήξτε τη λίστα προς τα κάτω για να δείτε το build σας.
If asked, click the green button to enable workflows. The list of workflows shows two entries: use «Build AAPS». Ignore «AAPS Builder»: it holds the build steps and has no «Run workflow» button.
Πατήστε «Run workflow» και μετά το πράσινο κουμπί «Run workflow». Το «latest» δημιουργεί την πιο νέα έκδοση του AAPS. συμβουλή: μπορείτε να δημιουργήσετε άλλη έκδοση γράφοντας το όνομα του tag της αντί για «latest»
Περιμένετε περίπου 15–30 λεπτά. Ένα πράσινο τικ σημαίνει ότι τελείωσε. Θέλετε ένα email όταν τελειώσει το build; Το GitHub σας στέλνει email μόνο όταν ένα build αποτύχει. Για να παίρνετε email και όταν πετύχει: στο github.com, ανοίξτε την εικόνα του προφίλ σας → Settings → Notifications → System → Actions και αποεπιλέξτε το «Only notify for failed workflows».
No «Build AAPS» / «Run workflow» button?
Open your repository and check that it has a folder
.githubwith the fileworkflows/build.yml. If the repository is empty, it was not created from the template: delete it (Settings → bottom of the page → Delete this repository) and do step 1 again with the button.The file is there, but GitHub shows «This workflow does not exist»: see troubleshooting.
Ανοίξτε την καρτέλα Actions. Αν λέει ότι τα workflows είναι απενεργοποιημένα, πατήστε το πράσινο κουμπί για να τα ενεργοποιήσετε. Μετά πατήστε «Build AAPS» στη λίστα.
Step 5 – Install on your phone
Before every update: back up your settings!
Στο AAPS: Συντήρηση → Εξαγωγή ρυθμίσεων. (Κάντε το έτσι κι αλλιώς τακτικά, π.χ. μετά από μια αλλαγή προφίλ ή μία φορά τον μήνα.)
Αντιγράψτε το αρχείο της εξαγωγής ΕΞΩ από το τηλέφωνο, π.χ. στο Google Drive ή στο Dropbox. Ένα αντίγραφο ασφαλείας που υπάρχει μόνο στο τηλέφωνο χάνεται μαζί με το τηλέφωνο.
Κρατήστε εκεί και τα αρχεία APK και αρκετές παλαιότερες εξαγωγές. Έτσι μπορείτε πάντα να επιστρέψετε σε προηγούμενη κατάσταση.
Πώς να κάνετε εξαγωγή ρυθμίσεων · Συχνές Ερωτήσεις AAPS: πώς να οργανώσετε τα αντίγραφα ασφαλείας
Ανοίξτε αυτή τη σελίδα στο τηλέφωνό σας, στον browser (Chrome). Συνδεθείτε στο github.com αν σας ζητηθεί.
-
Άνοιξε αντί γι” αυτό η εφαρμογή GitHub; Δεν μπορεί να κατεβάσει builds. Στην εφαρμογή, ανοίξτε το πιο νέο build και πατήστε «Artifacts ↗» ή πατήστε το εικονίδιο κοινοποίησης και επιλέξτε Chrome (ή «Copy link» και μετά επικολλήστε τον σύνδεσμο στη γραμμή διευθύνσεων του Chrome). Συνεχίστε στο Chrome.
Βλέπετε «Page not found» (404); Ελέγξτε πρώτα ότι είστε συνδεδεμένοι στο github.com σε αυτόν τον browser: το GitHub δείχνει 404 για ιδιωτικά αποθετήρια όταν δεν είστε συνδεδεμένοι. Αλλιώς, το όνομα χρήστη ή το όνομα αποθετηρίου στο βήμα 1 δεν ταιριάζει με το αποθετήριό σας: ελέγξτε τα στο github.com και γράψτε τα στο βήμα 1.
Για να μην ανοίγουν οι σύνδεσμοι του GitHub στην εφαρμογή: Ρυθμίσεις Android → Εφαρμογές → GitHub → Άνοιγμα από προεπιλογή → απενεργοποιήστε το «Άνοιγμα υποστηριζόμενων συνδέσμων» (Open supported links).
Πατήστε το πιο νέο build με πράσινο τικ ✅.
Κάντε κύλιση προς τα κάτω στη σύνοψη του build και πατήστε τον μεγάλο σύνδεσμο «📱 Download AAPS …» (ή κάντε κύλιση πιο κάτω στο «Artifacts» και πατήστε το aaps-….apk). Κάντε κύλιση με το δάχτυλο πάνω στο κείμενο, όχι πάνω στο διάγραμμα με τα βήματα του build.
Όταν τελειώσει η λήψη, πατήστε το αρχείο και επιλέξτε Εγκατάσταση (Install). Αν σας ζητηθεί, επιτρέψτε την εγκατάσταση εφαρμογών από αυτή την πηγή.
Το aaps-wear-….apk είναι για έξυπνο ρολόι. Παραλείψτε το αν δεν χρησιμοποιείτε ρολόι.
Το APK δεν φαίνεται στο «Code» του αποθετηρίου σας, μόνο στη σελίδα του build. Φυλάσσεται για 14 ημέρες.
Νέα έκδοση του AAPS; Back up your settings, then build it with step 4. Το αποθετήριό σας δεν δημιουργεί ποτέ τίποτα μόνο του.
Step 6 – Optional: get the app in Google Drive
Θέλετε το APK να εμφανίζεται στο Google Drive σας (και να μένει εκεί για πάντα); Add one more secret, GDRIVE_OAUTH2. This page gets it from Google for you. AAPS can then only see and change the files it creates in your Google Drive, nothing else.
-
Google opens in a new tab. Choose your Google account and allow AAPS to see and change its own files. If Google says the app is not verified, tap «Advanced», then «Go to …».
Then the new tab shows an error like «This site can’t be reached» or «127.0.0.1 refused to connect». This is expected. Google’s answer is in the address of that tab.
Tap the address bar of that tab, then the copy icon next to the address (on a computer: select the whole address and copy it). It starts with
http://127.0.0.1:47913/. Come back to this page within a few minutes: the answer is only valid for a short time.
-
Opens:
Getting «Page not found» (404)? Ελέγξτε πρώτα ότι είστε συνδεδεμένοι στο github.com σε αυτόν τον browser: το GitHub δείχνει 404 για ιδιωτικά αποθετήρια όταν δεν είστε συνδεδεμένοι. Αλλιώς, το όνομα χρήστη ή το όνομα αποθετηρίου στο βήμα 1 δεν ταιριάζει με το αποθετήριό σας: ελέγξτε τα στο github.com και γράψτε τα στο βήμα 1.
Tap «Copy name», then paste it into the small «Name» field:
GDRIVE_OAUTH2Tap «Copy secret», then paste the code into the big «Secret» box:
Πατήστε «Add secret».
Already have a GDRIVE_OAUTH2 value?
A value from the AAPS preparation page of the other browser build works too: open the secrets page, add the name GDRIVE_OAUTH2 and paste your value. See Save the builds in Google Drive.
Από το επόμενο build, τα APK αποθηκεύονται και στο Google Drive, στον φάκελο AAPS/<version>.
Αν δεν κάνετε build για 6 μήνες ή αν αλλάξετε τον κωδικό σας στο Google, η Google σταματά την πρόσβαση. Τότε το build σας το λέει: κάντε ξανά αυτό το βήμα.
Όλα σε αυτή τη σελίδα εκτελούνται στον browser σας. Το κλειδί και οι κωδικοί σας δεν στέλνονται ποτέ πουθενά, εκτός από εκεί όπου τα επικολλάτε εσείς. Μόνο το όνομα χρήστη σας στο GitHub στέλνεται στο GitHub, για να ελεγχθεί ότι υπάρχει. In step 6, the Google answer is sent only to Google, to get GDRIVE_OAUTH2. The build workflow is maintained by the AAPS developers in nightscout/aaps-builder, based on AAPS Builder (AGPL-3.0).
Ο μακρύς κώδικας αντιγράφηκε: επικολλήστε τον στο μεγάλο πλαίσιο «Secret» και μετά πατήστε «Add secret».
Το όνομα αντιγράφηκε: επικολλήστε το στο μικρό πεδίο «Name».
✓ Ο χρήστης GitHub βρέθηκε.
✗ Δεν υπάρχει χρήστης GitHub με αυτό το όνομα. Use your username (shown in your GitHub profile), not your e-mail.
Copied ✓
Enter your GitHub username in step 1 first.
Passwords and alias cannot contain the character |
Choose your keystore file.
Fill in password and alias.
Wrong keystore password.
Wrong key password.
Alias not found in the keystore. Διαθέσιμα: {aliases}
Αυτό δεν μοιάζει με αρχείο keystore.
Keystore OK! Continue with step 3.
Keystore read. Ο κωδικός θα ελεγχθεί κατά το build. Continue with step 3.
The password must be at least 8 characters.
Use only a–z, A–Z, 0–9 and symbols such as ! ? # – χωρίς κενά, χωρίς γράμματα με τόνους και όχι |
Οι κωδικοί δεν είναι ίδιοι.
Δημιουργία κλειδιού…
Key created. Download the backup below, then continue with step 3.
Paste the whole address of the Google tab first.
This address has no answer from Google. Copy the whole address of the tab that shows the error, starting with http://127.0.0.1:47913/
Google access was not allowed. Tap «Connect Google Drive» again and allow access.
This address belongs to an older attempt. Tap «Connect Google Drive» again and use the new address.
Asking Google…
Google did not accept it ({error}). The answer is valid only for a few minutes and only once: tap «Connect Google Drive» again.
Google sent no long-term access. Tap «Connect Google Drive» again.
GDRIVE_OAUTH2 is ready. Add it as a secret below.
Code copied: paste it in the big «Secret» box, then tap «Add secret».