Estou tentando compilar um jogo Playdate que estou criando em C, mas estou recebendo erros em funções que usam as variáveis de ponteiro pd
e pdsys
, que declarei no meu global.h
arquivo (como extern const
), mas às quais só posso atribuir um valor em um método executado quando a API do Playdate chama o evento de inicialização ( eventHandler()
).
Parte do problema é que eu entendo por que você não pode usar uma variável sem defini-la, já que C precisa saber o tamanho da variável, mas não entendo por que haveria um erro de compilação ao usar um ponteiro de variável sem que ele seja definido, já que o ponteiro tem um tamanho fixo.
Pela pesquisa que fiz, esse erro de compilação é causado por um código que usa uma variável sem definição, embora eu não tenha certeza de como fazer isso além de declará-la global.h
e atribuir um valor a ela no meu eventHandler()
. Acredito que isso não foi um problema quando declarei essas variáveis dentro main.c
de onde elas estão sendo usadas, mas conforme meu projeto cresceu em escopo, me vi precisando acessar essas variáveis em praticamente todos os outros arquivos do projeto. Pensei que a melhor solução para isso seria ter um arquivo que incluísse todos os outros arquivos, que contivesse as declarações pd
e pdsys
(e talvez até mais depois) para que pudessem ser acessadas de qualquer arquivo, mas se eu estiver enganado, agradeceria informações sobre a melhor forma de fazer isso!
Aqui estão o que acredito serem os trechos de código relevantes. O projeto contém mais, mas acredito que eles não fazem parte do problema e aumentariam ainda mais a questão se eu os incluísse:
main.c
#include "global.h"
#include "pd_api.h"
LCDSprite *pBall;
float crankTime;
int updateCallback(void *userdata) {
crankTime += pdsys->getCrankChange() * (float)M_PI/180;
pd->sprite->moveTo(pBall,
sin(crankTime/1) * 16 + 400/2,
sin(crankTime/2) * 32 + 240/2
);
// Updates and renders all LCDSprites
pd->sprite->updateAndDrawSprites();
return 1;
}
int eventHandler (PlaydateAPI *playdate, PDSystemEvent event, uint32_t arg) {
switch (event) {
// Game initialization!
case kEventInit:
pd = playdate; //Store the playdate API struct in pd variable
pdsys = playdate->system; //Store playdate system struct in pdsys variable
break;
// Default case to suppress warnings
default:
break;
}
playdate->system->logToConsole("eventHandler call received. %d", arg);
return 0;
}
global.h
#ifndef GLOBAL_H
#define GLOBAL_H
#include "pd_api.h"
extern const PlaydateAPI* pd;
extern const struct playdate_sys* pdsys;
#endif //GLOBAL_H
O erro que recebo quando tento compilar o projeto é o seguinte:
====================[ Build | all ]=============================================
make --jobs=10 all
detected_OS is "Darwin"
mkdir -p build
mkdir -p build/dep
mkdir -p `dirname build/src/main.o`
clang -g -dynamiclib -rdynamic -lm -DTARGET_SIMULATOR=1 -DTARGET_EXTENSION=1 -I . -I /Users/JaydedCompanion//Developer/PlaydateSDK//C_API -o build/pdex.dylib src/main.c src/global.c src/jaydes_pd_utils.c src/game.c src/ball.c /Users/JaydedCompanion//Developer/PlaydateSDK//C_API/buildsupport/setup.c
/usr/local/bin/arm-none-eabi-gcc -g3 -c -mthumb -mcpu=cortex-m7 -mfloat-abi=hard -mfpu=fpv5-sp-d16 -D__FPU_USED=1 -O2 -falign-functions=16 -fomit-frame-pointer -gdwarf-2 -Wall -Wno-unused -Wstrict-prototypes -Wno-unknown-pragmas -fverbose-asm -Wdouble-promotion -mword-relocations -fno-common -ffunction-sections -fdata-sections -Wa,-ahlms=build/main.lst -DTARGET_PLAYDATE=1 -DTARGET_EXTENSION=1 -MD -MP -MF build/dep/main.o.d -I . -I . -I /Users/JaydedCompanion//Developer/PlaydateSDK//C_API src/main.c -o build/src/main.o
/usr/local/bin/arm-none-eabi-gcc -g3 build/src/main.o build/src/global.o build/src/jaydes_pd_utils.o build/src/game.o build/src/ball.o build//Users/JaydedCompanion//Developer/PlaydateSDK//C_API/buildsupport/setup.o -nostartfiles -mthumb -mcpu=cortex-m7 -mfloat-abi=hard -mfpu=fpv5-sp-d16 -D__FPU_USED=1 -T/Users/JaydedCompanion//Developer/PlaydateSDK//C_API/buildsupport/link_map.ld -Wl,-Map=build/pdex.map,--cref,--gc-sections,--no-warn-mismatch,--emit-relocs -o build/pdex.elf
Undefined symbols for architecture x86_64:
"_pd", referenced from:
_updateCallback in main-b239cd.o
_eventHandler in main-b239cd.o
_ball in ball-c3812c.o
"_pdsys", referenced from:
_updateCallback in main-b239cd.o
_eventHandler in main-b239cd.o
_game_init in game-6fe6d9.o
ld: symbol(s) not found for architecture x86_64
clang: error: linker command failed with exit code 1 (use -v to see invocation)
make: *** [build/pdex.dylib] Error 1
make: *** Waiting for unfinished jobs....
/usr/local/playdate/gcc-arm-none-eabi-9-2019-q4-major/bin/../lib/gcc/arm-none-eabi/9.2.1/../../../../arm-none-eabi/bin/ld: build/src/main.o: in function `updateCallback':
/Users/JaydedCompanion/Documents/GitHub/PlaydateProject/src/main.c:24: undefined reference to `pdsys'
/usr/local/playdate/gcc-arm-none-eabi-9-2019-q4-major/bin/../lib/gcc/arm-none-eabi/9.2.1/../../../../arm-none-eabi/bin/ld: /Users/JaydedCompanion/Documents/GitHub/PlaydateProject/src/main.c:24: undefined reference to `pd'
/usr/local/playdate/gcc-arm-none-eabi-9-2019-q4-major/bin/../lib/gcc/arm-none-eabi/9.2.1/../../../../arm-none-eabi/bin/ld: build/src/main.o: in function `eventHandler':
/Users/JaydedCompanion/Documents/GitHub/PlaydateProject/src/main.c:55: undefined reference to `pd'
/usr/local/playdate/gcc-arm-none-eabi-9-2019-q4-major/bin/../lib/gcc/arm-none-eabi/9.2.1/../../../../arm-none-eabi/bin/ld: /Users/JaydedCompanion/Documents/GitHub/PlaydateProject/src/main.c:55: undefined reference to `pdsys'
collect2: error: ld returned 1 exit status
make: *** [build/pdex.elf] Error 1
Process finished with exit code 2
Não tenho certeza se o makefile faz parte do problema, então não o incluirei para não tornar esta pergunta ainda mais longa, mas posso confirmar que ele inclui os arquivos de origem relevantes e não tem sido um problema até agora. Admito que é um makefile que obtive dos projetos de exemplo incluídos na API C do Playdate, pois tenho pouquíssima experiência trabalhando com C e ainda menos experiência usando makefiles. Além disso, a documentação da API C do Playdate praticamente não contém informações sobre como escrever um makefile para projetos do Playdate e sugere que as pessoas simplesmente usem os makefiles de exemplo, como eu fiz. Se for provável que esta seja uma informação pertinente, no entanto, terei prazer em editar esta publicação para incluí-la.
Para vincular um programa em C, todos os objetos precisam ser definidos. Uma variável de ponteiro não é exceção, e é por isso que você tem este erro. Uma declaração apenas informa ao compilador que o objeto declarado está em outro lugar .
No entanto, não é necessário inicializar uma variável de ponteiro com o ponteiro para um objeto existente . Você pode fazer isso em tempo de execução, conforme desejar.
Simplifiquei seus trechos para um exemplo completo e simples.
Esta função principal chama uma função de carregamento para atribuir o ponteiro a alguns dados da variável de ponteiro global. Neste caso, é uma string simples.
Não defina variáveis globais em arquivos de cabeçalho. Em vez disso, declare-as, caso contrário, haverá tantas definições no seu programa quantas forem as que você incluir no arquivo de cabeçalho.
Para fornecer a variável de ponteiro declarada, você precisa de outro módulo. É uma boa prática incluir o arquivo de cabeçalho de declaração para que o compilador relate quaisquer discrepâncias. Não há necessidade de inicializar essa variável explicitamente, pois a variável global, como um objeto estático, é inicializada automaticamente com zero.
O carregador tem seu próprio arquivo de cabeçalho declarando a função do carregador:
E sua implementação atribui um endereço à variável global. No seu caso, você alocaria memória e a preencheria ou faria o que achasse adequado.
Eu construí o exemplo com esta linha de comando:
Nota 1: Após décadas de programação em C, considero um código defeituoso fornecer um "global.h" com declarações de variáveis globais, constantes e assim por diante. Em vez disso, pense no seu design e encapsule elementos coerentes em módulos.
Nota 2: Além disso, você pode projetar sua arquitetura de software de forma que o ponteiro para os dados carregados seja fornecido por outra função do módulo carregador. Isso encapsularia e atribuiria a responsabilidade a algum módulo significativo.
Não é um erro de compilação, apenas um erro de vinculação. O vinculador pega todos os arquivos de objeto e cria o arquivo executável. O vinculador precisa que todos os objetos sejam definidos em algum lugar. Não importa o tipo deles.
extern const PlaydateAPI* pd;
Ele declarapd
que o objeto ie informa ao compilador que o objeto com nomepd
está definido em algum lugar nos arquivos de origem. Esta declaração não o define (cria).const PlaydateAPI* pd;
- define o objetopd
, ou seja, o cria fisicamente.