Penyelesaian masalah

Sketch tidak terkompilasi

Membaca tab Build, dan lima penyebab yang biasanya terjadi.

Yang kamu lihat: tab Build

Tab ini ada di bawah strip file di panel kode. Tab ini mendaftar langkah-langkah beserta waktunya, lalu output compiler itu sendiri sebagai baris yang bisa diklik. Klik satu baris dan editor melompat ke file, baris, dan kolom tersebut.

Diagnostiknya adalah diagnostik clang sungguhan, tanpa diedit. Posisi di sketch-mu adalah posisi di sketch-mu: file dikompilasi dengan namanya sendiri, jadi nomor barisnya memang milikmu, bukan milik sebuah pembungkus.

Error linker tidak punya posisi. ld.lld: error: undefined symbol: loop() muncul sebagai baris tanpa lompatan, karena memang tidak ada tujuan lompatan.

1. Include yang hilang

Yang paling sering, dan punya gejala khasnya sendiri: clang berhenti total saat header hilang. Panel build menganggapnya build gagal dan menampilkan diagnostiknya alih-alih melaporkan crash, jadi carilah baris file not found.

Hanya header dari proyekmu sendiri, library-nya, dan milik runtime yang tersedia. Build itu sendiri tanpa jaringan: sebuah library sudah ada di proyek sebelum build dimulai, atau tidak ada sama sekali.

The runtime's own include the stock libraries tutorials use most, under their usual names: Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h, Adafruit_SSD1306.h, Adafruit_NeoPixel.h, DHT.h, SoftwareSerial.h and TinyGPS++.h (daftarnya, dan apa cakupan masing-masing). Header yang ditulis dengan kapitalisasi berbeda, seperti yang sering terjadi pada sketch yang ditulis di Windows atau Mac (servo.h, liquidcrystal_i2c.h), is read as the one Mokxi has. For any other library the Build tab names the Mokxi header that does the same job, or offers Install with the library's name: one tap fetches it from the Arduino Library Manager, with the libraries it depends on, puts it in the project and builds again. The Arduino Library Manager search under the code finds any library in the official index by name, header or what it does. A library that does not list your board installs with a warning, and you can still try it. Your own files go in with Add library.

2. Fungsi yang tidak ada di runtime ini

Runtime ini milik kami: C dan C++ freestanding dengan API dari Arduino language reference. Runtime ini membawa pinMode, digitalWrite, digitalRead, analogWrite, analogRead, millis, micros, delay, delayMicroseconds, pulseIn, shiftIn, shiftOut, tone, noTone, attachInterrupt, Serial dengan parseInt dan readStringUntil, String, floating point dan library matematika, uji karakter, dan sprintf dengan sisa library C yang dipakai tutorial lain, plus driver bersama untuk display dan strip WS2812 (daftarnya).

Ini bukan avr-libc, bukan core Arduino dan bukan ESP-IDF, dan semuanya tidak diambil saat build. Panggilan yang berhasil di Arduino sungguhan bisa saja tidak ada di sini (analogRead di board yang konverternya tidak dimodelkan, misalnya), dan build akan mengatakannya.

3. File yang salah adalah main

Sebuah proyek punya beberapa file dan salah satunya adalah tempat compiler memulai. Kalau kamu mengganti nama sketch, pastikan file yang kamu harapkan menjadi titik masuk memang masih jadi titik masuk.

4. Sudah dikompilasi, tapi Jalankan menjalankan yang lain

Ada tiga hal yang bisa terjadi saat kamu menekan Jalankan, dan hanya satu di antaranya adalah build:

  • board menjalankan contoh yang sudah jadi atau ELF yang diunggah, dan tidak ada yang dikompilasi;
  • board memakai build terakhir, karena tidak satu byte pun dari file yang berubah;
  • board di-build.

ELF yang kamu unggah tidak dibangun dari file-file ini, jadi dia yang menang: program board di panel properti tertulis Uploaded ELF selama itu ada di sana. Kalau simulator menolaknya, pesannya menawarkan Gunakan kodenya, yang mengembalikan board ke kode di editor.

5. Bisa dikompilasi di Arduino IDE, tapi tidak di sini

Dua hal yang Arduino IDE lakukan untuk sebuah sketch, Mokxi juga melakukannya, jadi sketch yang disalin dari tutorial tidak tersandung keduanya.

  • Fungsi bisa dipanggil sebelum didefinisikan. Arduino IDE menulis prototype untuk setiap fungsi di tab .ino sebelum mengompilasinya, dan Mokxi juga begitu, jadi loop() bisa memanggil fungsi yang didefinisikan lebih bawah. Beberapa tab .ino digabung jadi satu file, tab utama lebih dulu, seperti IDE menggabungkannya. Template fungsi mendapatkan prototype-nya dengan baris template <typename T> di depan, seperti yang IDE tulis. Beberapa fungsi tidak mendapat prototype: fungsi di dalam class atau namespace, template dengan argumen template bawaan, dan fungsi yang tipe parameternya dideklarasikan lebih bawah di sketch. Untuk itu, panggilan di atas definisi menjadi use of undeclared identifier, dan tab Build menyebutkan di baris mana fungsinya: pindahkan fungsinya, atau tipe yang dipakainya, ke atas kode yang memanggilnya, atau taruh prototype satu baris seperti void blinkTwice(); di paling atas.
  • Warning tidak menghentikan build. File-mu dikompilasi dengan -Wall -Wextra, dan tab Build mencantumkan apa yang ditemukannya, tapi sketch tetap di-build dan berjalan, seperti di IDE. Variabel atau parameter yang tidak dipakai dan perbandingan signed dan unsigned (int i < sizeof(pins)) bisa menunggu. if (x = HIGH) sebaiknya diperbaiki: satu = berarti memberi nilai, jadi kondisinya selalu benar, dan yang kamu maksud adalah ==.

Sisanya biasanya library yang tidak tersedia di Mokxi, atau fungsi yang tidak disediakan runtime board tersebut: bagian 1 dan 2 di atas.

Build errors dalam bahasa sederhana membahas pesan-pesan umum satu per satu, dan Arduino compile errors explained memuatnya dalam kata-kata GCC maupun clang.

Kalau build pertama terasa macet

Itu tidak macet, itu sedang mengunduh. Toolchain-nya sekitar tujuh puluh megabyte berupa clang dan dialirkan sekali saja, lalu tinggal di cache browser. Langkah-langkah di tab Build menunjukkan posisinya. Kunjungan berikutnya sekitar satu setengah detik, dan setelah itu mengedit lalu menjalankan hanya sepersekian detik. Kalau gagal diunduh, lihat editor atau compiler tidak mau dimuat.

Masih bingung

Mengompilasi di browser adalah kontrak lengkapnya: daftar perintah, kunci cache, dan bagaimana runtime dirakit. Atau tulis kepada kami dari /support dengan hasil diagnosisnya.