התקנת תעודה עבור סביבת Flutter: הבדלים בין גרסאות בדף
| (10 גרסאות ביניים של 3 משתמשים אינן מוצגות) | |||
| שורה 2: | שורה 2: | ||
{{ניווט|תעודת האבטחה}} | {{ניווט|תעודת האבטחה}} | ||
| − | + | {{תיבת מידע| | |
| + | שימו לב שההוראות שלהלן לא ישפיע על קריאות הרשת מהאפליקציה עצמה אלא רק על הסביבת פיתוח. | ||
| − | + | האפליקציה עצמה היא מעין VM ולא סומכת על התעודות שמותקנות במכשיר. כפי שניתן לראות [https://github.com/JagandeepBrar/lunasea/issues/255#issuecomment-692378876 כאן] נכון להיום (3.4.2024) לא אפשרי להגדיר לאפליקציה לסמוך על התעודות שמותקנות במערכת, הפתרון הוא [https://github.com/flutter/flutter/issues/50699#issuecomment-653855688 להטמיע את התעודות באפליקציה עצמה], או להשבית לחלוטין את הבדיקת SSL. | |
| + | }} | ||
| − | + | ===windows=== | |
| + | |||
| + | יש לוודא שהותקנה תוכנת ההתקנה של התעודת אבטחה, בכל מקרה של ספק התקינו אותה שוב (אפשר להוריד מ[https://netfree.link/pc/windows/CertInstaller.exe פה]). | ||
| + | |||
| + | ==== הגדרת Dart SDK ==== | ||
| + | כדי שפקודות ה-Dart והורדת החבילות (pub get) יזהו את התעודה, הריצו את הפקודה הבאה בשורת פקודה (CMD): | ||
| + | <pre>SETX DART_VM_OPTIONS --root-certs-file=C:\ProgramData\NetFree\CA\netfree-ca-bundle-curl.crt</pre> | ||
| + | |||
| + | ==== פתרון שגיאת SSL בבנייה ל-Windows (CMake) ==== | ||
| + | בעת בנייה או הרצת Debug עבור Windows, כלי הבנייה ה-CMake עשוי להיכשל בהורדת רכיבים (שגיאה 60 או CERT_TRUST_REVOCATION_STATUS_UNKNOWN). | ||
| + | כדי לפתור זאת, יש להגדיר משתנה סביבה המורה ל-CMake לדלג על אימות ה-SSL: | ||
| + | |||
| + | '''אפשרות א': פתרון קבוע (מומלץ)''' | ||
| + | פתרון זה יאפשר הרצת Debug ישירות מה-IDE (כמו VS Code). | ||
| + | # חפשו ב-Windows: "עריכת משתני הסביבה של המערכת". | ||
| + | # לחצו על כפתור "משתני סביבה". | ||
| + | # תחת "משתני משתמש", לחצו על "חדש" והוסיפו: | ||
| + | #* '''שם המשתנה:''' <code>CMAKE_TLS_VERIFY</code> | ||
| + | #* '''ערך המשתנה:''' <code>0</code> | ||
| + | # לאחר האישור, יש לאתחל מחדש את סביבת הפיתוח (VS Code / Android Studio). | ||
| + | |||
| + | '''אפשרות ב': פתרון זמני בטרמינל (PowerShell)''' | ||
| + | הריצו את הפקודה הבאה לפני פקודת הבנייה: | ||
| + | <pre>$env:CMAKE_TLS_VERIFY="0" | ||
| + | flutter build windows</pre> | ||
| + | |||
| + | לאחר בנייה מוצלחת, ניתן לשחזר את ההגדרות (למחוק את משתנה הסביבה הזמני מהזכרון) על ידי הפקודה: | ||
| + | <pre>Remove-Item Env:\CMAKE_TLS_VERIFY -ErrorAction SilentlyContinue</pre> | ||
| + | |||
| + | |||
| + | ===linux=== | ||
| + | |||
| + | אם התקנתם את התעודה לפי ההוראות [[התקנת תעודה במערכת ההפעלה Ubuntu|כאן]], תוכלו לערוך את קובץ הפרופיל (/etc/profile) ולהוסיף בסופו את השורה הבאה: | ||
| + | |||
| + | export DART_VM_OPTIONS --root-certs-file='''/usr/lib/ssl/certs/ca-certificates.crt''' | ||
| + | |||
| + | |||
| + | ===mac=== | ||
| + | |||
| + | הורידו את קובץ התעודות של נטפרי מ[https://netfree.link/cacert/cacert-bundle-curl-plus-netfree.pem כאן] ושמרו במקום קבוע במחשב . | ||
| + | |||
| + | לאחר מכן צריך להוסיף בקובץ הפרופיל של שורת הפקודה בה אתם משתמשים משתנה סביבה שיצביע על התעודות של נטפרי . | ||
| + | |||
| + | *אם אתם משתמשים ב-'''bash''', קובץ הפרופיל נמצא בנתיב <code>bash_profile./~</code> או בנתיב <code>bashrc./~</code> | ||
| + | |||
| + | *אם אתם משתמשים ב-'''zsh''' (ברירת המחדל מ-Catalina 10.15 ואילך), קובץ הפרופיל נמצא בנתיב <code>zshenv./~</code> | ||
| + | |||
| + | *אם אתם משתמשים ב-'''Oh my zsh''', קובץ הפרופיל נמצא בנתיב <code>zshrc./~</code> | ||
| + | |||
| + | ניתן להשתמש בפקודה הבאה כדי להוסיף בקובץ הפרופיל את ההגדרה הנ<nowiki>''</nowiki>ל , | ||
| + | |||
| + | יש לשנות את zshenv./~ לנתיב של קובץ הפרופיל של הטרמינל בו אתם משתמשים וכמובן לשנות את <code>path/to/curl-ca-bundle.pem/</code> לנתיב בו שמרתם את קובץ התעודות . | ||
| + | echo export DART_VM_OPTIONS --root-certs-file=/path/to/curl-ca-bundle.pem >> ~/.zshenv | ||
| + | |||
| + | '''לאחר מכן יש להפעיל חלון טרמינל חדש.''' | ||
גרסה אחרונה מ־14:42, 19 בפברואר 2026
למעבר מתצוגת עריכה לתצוגת קריאה
עמוד ראשי > תעודת האבטחה > התקנת תעודה עבור סביבת Flutter
ℹ️ שימו לב שההוראות שלהלן לא ישפיע על קריאות הרשת מהאפליקציה עצמה אלא רק על הסביבת פיתוח.
האפליקציה עצמה היא מעין VM ולא סומכת על התעודות שמותקנות במכשיר. כפי שניתן לראות כאן נכון להיום (3.4.2024) לא אפשרי להגדיר לאפליקציה לסמוך על התעודות שמותקנות במערכת, הפתרון הוא להטמיע את התעודות באפליקציה עצמה, או להשבית לחלוטין את הבדיקת SSL.
windows
יש לוודא שהותקנה תוכנת ההתקנה של התעודת אבטחה, בכל מקרה של ספק התקינו אותה שוב (אפשר להוריד מפה).
הגדרת Dart SDK
כדי שפקודות ה-Dart והורדת החבילות (pub get) יזהו את התעודה, הריצו את הפקודה הבאה בשורת פקודה (CMD):
SETX DART_VM_OPTIONS --root-certs-file=C:\ProgramData\NetFree\CA\netfree-ca-bundle-curl.crt
פתרון שגיאת SSL בבנייה ל-Windows (CMake)
בעת בנייה או הרצת Debug עבור Windows, כלי הבנייה ה-CMake עשוי להיכשל בהורדת רכיבים (שגיאה 60 או CERT_TRUST_REVOCATION_STATUS_UNKNOWN). כדי לפתור זאת, יש להגדיר משתנה סביבה המורה ל-CMake לדלג על אימות ה-SSL:
אפשרות א': פתרון קבוע (מומלץ) פתרון זה יאפשר הרצת Debug ישירות מה-IDE (כמו VS Code).
- חפשו ב-Windows: "עריכת משתני הסביבה של המערכת".
- לחצו על כפתור "משתני סביבה".
- תחת "משתני משתמש", לחצו על "חדש" והוסיפו:
- שם המשתנה:
CMAKE_TLS_VERIFY - ערך המשתנה:
0
- שם המשתנה:
- לאחר האישור, יש לאתחל מחדש את סביבת הפיתוח (VS Code / Android Studio).
אפשרות ב': פתרון זמני בטרמינל (PowerShell) הריצו את הפקודה הבאה לפני פקודת הבנייה:
$env:CMAKE_TLS_VERIFY="0" flutter build windows
לאחר בנייה מוצלחת, ניתן לשחזר את ההגדרות (למחוק את משתנה הסביבה הזמני מהזכרון) על ידי הפקודה:
Remove-Item Env:\CMAKE_TLS_VERIFY -ErrorAction SilentlyContinue
linux
אם התקנתם את התעודה לפי ההוראות כאן, תוכלו לערוך את קובץ הפרופיל (/etc/profile) ולהוסיף בסופו את השורה הבאה:
export DART_VM_OPTIONS --root-certs-file=/usr/lib/ssl/certs/ca-certificates.crt
mac
הורידו את קובץ התעודות של נטפרי מכאן ושמרו במקום קבוע במחשב .
לאחר מכן צריך להוסיף בקובץ הפרופיל של שורת הפקודה בה אתם משתמשים משתנה סביבה שיצביע על התעודות של נטפרי .
- אם אתם משתמשים ב-bash, קובץ הפרופיל נמצא בנתיב
bash_profile./~או בנתיבbashrc./~
- אם אתם משתמשים ב-zsh (ברירת המחדל מ-Catalina 10.15 ואילך), קובץ הפרופיל נמצא בנתיב
zshenv./~
- אם אתם משתמשים ב-Oh my zsh, קובץ הפרופיל נמצא בנתיב
zshrc./~
ניתן להשתמש בפקודה הבאה כדי להוסיף בקובץ הפרופיל את ההגדרה הנ''ל ,
יש לשנות את zshenv./~ לנתיב של קובץ הפרופיל של הטרמינל בו אתם משתמשים וכמובן לשנות את path/to/curl-ca-bundle.pem/ לנתיב בו שמרתם את קובץ התעודות .
echo export DART_VM_OPTIONS --root-certs-file=/path/to/curl-ca-bundle.pem >> ~/.zshenv
לאחר מכן יש להפעיל חלון טרמינל חדש.