Português:Dúvidas frequentes e soluções

As Páginas Não Aparecem no Menu de Contexto
Você pode se deparar com uma situação onde as páginas não estejam aparecento no menu de contexto, embora tenha definido menu="true". A razão é que existem algumas palavras que não são permitidas, a mais comum delas é "About" (Sobre).

A lista completa das palavras que não são permitidas pode ser encontrada nesta página da Adobe. Se você liga um page node no menu e ele possui um desses títulos, não será mostrado.

Caracteres Não-Latinos nos Títulos Causam Erros no SWFAddress
Você não pode ter caracteres não-Latinos nas urls com o SWFAddress, então se você tem esses caracteres no título das suas páginas, use o atributo route em seus page nodes para criar uma url válida, preservando o título de suas páginas.

Erros de Compilação Sobre Classes Faltando ou Propriedades Inválidas
Depois de atualizar um projeto existente do Gaia, se você compila e/ou executa erros sobre classes faltando ou propriedades inválidas, a solução é ter certeza de sempre deletar os arquivos ASO depois de atualizar. Você pode fazer isso através do menu Control > Delete ASO Files.

Erro de coerção do MovieClip ao IPreloader
Erros de Coerção ocorrem quando o arquivo do Flash em questão não compilou corretamente. Isso ocorre com frequência quando as pessoas fazem preloaders customizados baseados no PreloaderScaffold. Você tem que se certificar que o arquivo preload.fla compila sem erros, ou o Flash não estará apto a tratá-lo como a classe correta (IPreloader). Isso também pode acontecer a seus arquivos de página do Flash, nesse caso você pode ver um erro de coerção para do MovieClip para IPage ou algo em torno dessas linhas. Isto sempre acontece porque o arquivo do Flash não compilou corretamente.

Mensagens de Interrupt In/Out/Cross na Janela Output
Você verá >>> INTERRUPT IN <<< se uma página em transição não executou o método transitionOutComplete corretamente.

Você verá >>> INTERRUPT OUT <<< se uma página em transição não executou o método transitionInComplete corretamente.

Você verá >>> INTERRUPT CROSS <<< se há alguma combinação dos itens acima ou você está usando Cross Flow.

Note que a página está falhando ao chamar seu método completo de transição.

Se você fez um preloader customizado, também pode ter que checar se o preloader está executando seu método complete corretamente.

Páginas/Assets não Descarregam
Leia o artigo de Grant Skinner (em inglês) sobre este assunto se você está desenvolvendo com Gaia AS3.

Declarando Instâncias do Stage em Classes
Quando declarar instâncias nas suas classes que estão no stage, no Flash IDE, você precisa checar se declarou como public. Isso é uma exigência do AS3, mas muita gente tropeça aí, por isso vale uma nota aqui.

TypeError #1009 Ao Usar TweenLite
Isso acontece quando você passa ao TweenLite uma interface do Gaia, como IMovieClip ou IDisplayObject. A solução é não englobar o asset em sua interface, ou então passar a propriedade .content ao asset.