Importfehler¶
Ziel¶
Helfen Sie dabei, schnell zu entscheiden, ob der aktuelle Fehler eine nicht unterstützte Eingabe, eine Nichtübereinstimmung des Importpfads oder ein proaktiver Stopp des Laufzeitschutzes ist.
Unterstützte Plattformen¶
iOSmacOS
Zielgruppe¶
- Benutzer, deren Importpfad sich nicht wie erwartet verhielt
- Tester prüfen Importfehler, ignorierte Importe oder verschlechterte Appgebnisse
Voraussetzungen¶
- Sie müssen einen bestimmten Importfall, eine bestimmte Nachricht oder einen bestimmten Reproduktionspfad überprüfen
- Behalten Sie nach Möglichkeit die Quelldatei und den genauen Importpfad bei, der das Problem ausgelöst hat
Schritte¶
- Stellen Sie fest, ob der Fehler vor der Dateiauswahl, nach der Dateiauswahl oder nach dem Betreten des Arbeitsbereichs aufgetreten ist.
- Prüfen Sie, welcher Importpfad verwendet wurde und ob die Quelle dort unterstützt werden soll.
- Vergleichen Sie das beobachtete Verhalten mit den folgenden Fehlermustern, einschließlich unveränderter Neuimporte und teilweiser DSN-Verschlechterungswarnungen.
- Notieren Sie die genaue Nachricht und den Quellkontext, bevor Sie es erneut versuchen.
Ergebnis¶
- Sie können das Problem auf eine nicht unterstützte Eingabe, eine Pfadinkongruenz, einen Schutzstopp, einen unveränderten Neuimport oder einen Fall einer lokalen Verschlechterung eingrenzen.
Schauen Sie sich zuerst diese drei Dinge an¶
- Ist der Fehler vor der Dateiauswahl, nach der Dateiauswahl oder nach dem Betreten des Arbeitsbereichs aufgetreten?
- Hat die App eine eindeutige Fehlermeldung angezeigt?
- War die Aktion ein Neuimport, Revision anhängen oder SES?
Die derzeit häufigsten Fehlertypen¶
1. Nicht unterstützter Eingabetyp¶
Typische Anzeichen:
- Die App sagt direkt, dass die Erweiterung nicht unterstützt wird
- Der Fluss stoppt, nachdem Sie die Datei ausgewählt haben
Vorgeschlagene Maßnahmen:
- Bestätigen Sie zunächst, ob Sie den Design- oder Fertigungspfad verwendet haben
- Überprüfen Sie dann, ob die Eingabe zum aktuell unterstützten Satz gehört
2. Falsche IPC-2581-Importabsicht¶
Typische Anzeichen:
- Die Datei kann zwar ausgewählt werden, das resultierende Importverhalten entspricht jedoch nicht Ihren Erwartungen
Vorgeschlagene Maßnahmen:
- importieren Sie es erneut
- Wählen Sie erneut aus, ob es als konstruktionsseitige oder fertigungsseitige Daten behandelt werden soll
3. Falsche Verwendung von SES¶
Typische Anzeichen:
- Ich versuche,
SESzu importieren, als wäre es ein normales neues Dokument - oder das aktuelle Dokument hat keine verwendbare Basisrevision
Vorgeschlagene Maßnahmen:
- Öffnen Sie das Zieldokumentmenü
- Beginnen Sie mit
Import SES - Wählen Sie zunächst eine gültige Basisrevision aus
4. Großes IPC-2581 öffnet sich langsam oder schlägt während des echten Imports fehl¶
Die aktuelle Implementierung stoppt sehr große IPC-2581 XML-Eingaben nicht mehr mit einem konservativen Stabilitätsprüfung.
Wenn diese Art von Quelle immer noch fehlschlägt, tritt der Fehler jetzt im echten Importpfad auf, anstatt vor dem Öffnen abgelehnt zu werden.
Vorgeschlagene Maßnahmen:
- Erfassen Sie den genauen Fehlertext oder die letzte sichtbare Ladestufe
- Notieren Sie die Dateigröße, die Plattform und das Gerätemodell
- Beachten Sie, ob die App weiterhin reagierte, ins Stocken geriet oder vom Betriebssystem beendet wurde
5. Eine andere Importaufgabe läuft bereits¶
In der aktuellen Implementierung ist jeweils nur eine PCB-Importaufgabe zulässig. Wenn ein vorheriger Import noch nicht abgeschlossen ist, wird die nächste Importanfrage mit einer Statusmeldung abgelehnt.
6. Eingaben mit demselben Namen und demselben Format werden als unverändert gewertet¶
Die aktuelle Implementierung vergleicht die ursprünglichen Quellbytes, wenn Sie eine Quelle mit demselben Dokumentnamen und demselben Format erneut importieren:
- Wenn die neu importierte Originalquelle mit der aktuellen Revision identisch ist, meldet die App, dass der Import ignoriert wurde, da sich nichts geändert hat
- dies wird nicht als Fehler behandelt; Auf diese Weise werden doppelte Überarbeitungen vermieden
- Wenn Sie eine neue Revision erwartet haben, bestätigen Sie, dass sich der Dateiinhalt tatsächlich geändert hat
7. DSN Verschlechterung der lokalen Geometrie nach einem erfolgreichen Import¶
Typische Anzeichen:
- Der Import gelingt letztendlich und das Dokument wird geöffnet
- aber das Entwicklerprotokoll oder die Konsole zeigt Warnungen wie
skipping display object variant ... no valid shapes could be extractedan
Was es bedeutet:
- Der App konnte für eine kleine Anzahl von Anzeigevarianten keine gültige Kontur extrahieren, sodass diese lokalen Varianten übersprungen wurden und der Rest der Platine mit dem Import fortfuhr
- Dieses Verhalten soll verhindern, dass der gesamte Board-Import fehlschlägt oder abstürzt, und es wirkt sich normalerweise nur auf das lokale Rendering und nicht auf das gesamte Dokument aus
Vorgeschlagene Maßnahmen:
- Prüfen Sie zunächst, ob der betroffene Bereich noch für die von Ihnen gewünschte Aufgabe nutzbar ist
- Wenn die fehlende Geometrie von Bedeutung ist, notieren Sie den Warntext, das ursprüngliche
DSNund die Reproduktionsschritte für die Folgeuntersuchung
KiCad-spezifischer Hinweis¶
Auch wenn ein KiCad-Board im Sinne von 2D erfolgreich importiert wird, können fehlende oder nicht lesbare projektlokale 3D-Assets später in 3D oder bei der Diagnose immer noch als Probleme auftauchen. Das blockiert nicht immer das Öffnen von 2D, kann aber die Vollständigkeit von 3D verringern.
Was aufzuzeichnen ist¶
- Plattform und Gerät
- Importpfadtyp: Design / Fertigung / SES
- Originaldateityp und -größe
- der ursprüngliche Fehlertext
- ob es sich konsistent reproduziert
- ob bereits ein anderer Importauftrag lief
Häufige Fragen¶
Warum können einige Fertigungseingaben importiert werden, obwohl es sich um Ordner handelt?¶
Weil der Herstellungspfad Eingaben im Verzeichnisstil akzeptiert. Ob der Import erfolgreich ist, hängt davon ab, ob der App das Verzeichnis als unterstütztes Fertigungspaket erkennen kann.
Warum befindet sich nach einem fehlgeschlagenen Import keine neue Karte in der Bibliothek?¶
Das bedeutet normalerweise, dass der Fehler vor der Dokumenterstellung aufgetreten ist, z. B. eine nicht unterstützte Eingabe, eine Stabilitätsprüfung oder ein Fehler bei der Erkennung des Importeurs.
Warum habe ich nach dem zweiten Import desselben Dateinamens keine neue Revision erhalten?¶
Wenn die App sagt, dass der Import ignoriert wurde, weil sich nichts geändert hat, bedeutet das, dass die neu importierte Originalquelle mit der aktuellen Revision identisch ist. Die aktuelle Implementierung überspringt es, anstatt eine doppelte Revision zu erstellen.
Beim zweiten Versuch klappte es. Soll ich es trotzdem aufnehmen?¶
Ja. Zeitweilige Ausfälle sind für die Stabilitätsbewertung immer noch von Bedeutung.